Create a new podcast.

POST

https://demo.azuracast.com/api/station/{station_id}/podcasts

curl -X POST 'https://demo.azuracast.com/api/station/0/podcasts' \
  -H 'X-API-Key: YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "id": "string",
  "storage_location_id": 0,
  "source": "string",
  "playlist_id": 0,
  "playlist_auto_publish": true,
  "title": "string",
  "link": "string",
  "description": "string",
  "description_short": "string",
  "explicit": true,
  "is_enabled": true,
  "branding_config": {
    "public_custom_html": "string",
    "enable_op3_prefix": true
  },
  "language": "string",
  "language_name": "string",
  "author": "string",
  "email": "string",
  "has_custom_art": true,
  "art": "string",
  "art_updated_at": 0,
  "guid": "string",
  "is_published": true,
  "episodes": 0,
  "categories": [
    {
      "category": "string",
      "text": "string",
      "title": "string",
      "subtitle": "string"
    }
  ]
}'

const body = `{
  "id": "string",
  "storage_location_id": 0,
  "source": "string",
  "playlist_id": 0,
  "playlist_auto_publish": true,
  "title": "string",
  "link": "string",
  "description": "string",
  "description_short": "string",
  "explicit": true,
  "is_enabled": true,
  "branding_config": {
    "public_custom_html": "string",
    "enable_op3_prefix": true
  },
  "language": "string",
  "language_name": "string",
  "author": "string",
  "email": "string",
  "has_custom_art": true,
  "art": "string",
  "art_updated_at": 0,
  "guid": "string",
  "is_published": true,
  "episodes": 0,
  "categories": [
    {
      "category": "string",
      "text": "string",
      "title": "string",
      "subtitle": "string"
    }
  ]
}`;

const response = await fetch('https://demo.azuracast.com/api/station/0/podcasts', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_TOKEN',
    'Content-Type': 'application/json',
  },
  body,
});

const data = await response.text();

import requests

body = '''{
  "id": "string",
  "storage_location_id": 0,
  "source": "string",
  "playlist_id": 0,
  "playlist_auto_publish": true,
  "title": "string",
  "link": "string",
  "description": "string",
  "description_short": "string",
  "explicit": true,
  "is_enabled": true,
  "branding_config": {
    "public_custom_html": "string",
    "enable_op3_prefix": true
  },
  "language": "string",
  "language_name": "string",
  "author": "string",
  "email": "string",
  "has_custom_art": true,
  "art": "string",
  "art_updated_at": 0,
  "guid": "string",
  "is_published": true,
  "episodes": 0,
  "categories": [
    {
      "category": "string",
      "text": "string",
      "title": "string",
      "subtitle": "string"
    }
  ]
}'''

response = requests.post(
    'https://demo.azuracast.com/api/station/0/podcasts',
    data=body.encode('utf-8'),
    headers={
        'X-API-Key': 'YOUR_TOKEN',
        'Content-Type': 'application/json',
    },
)
print(response.text)

Request Body

{
  "id": "string",
  "storage_location_id": 0,
  "source": "string",
  "playlist_id": 0,
  "playlist_auto_publish": true,
  "title": "string",
  "link": "string",
  "description": "string",
  "description_short": "string",
  "explicit": true,
  "is_enabled": true,
  "branding_config": {
    "public_custom_html": "string",
    "enable_op3_prefix": true
  },
  "language": "string",
  "language_name": "string",
  "author": "string",
  "email": "string",
  "has_custom_art": true,
  "art": "string",
  "art_updated_at": 0,
  "guid": "string",
  "is_published": true,
  "episodes": 0,
  "categories": [
    {
      "category": "string",
      "text": "string",
      "title": "string",
      "subtitle": "string"
    }
  ]
}

{
  "links": {},
  "id": "string",
  "storage_location_id": 0,
  "source": "string",
  "playlist_id": 0,
  "playlist_auto_publish": true,
  "title": "string",
  "link": "string",
  "description": "string",
  "description_short": "string",
  "explicit": true,
  "is_enabled": true,
  "branding_config": {
    "public_custom_html": "string",
    "enable_op3_prefix": true
  },
  "language": "string",
  "language_name": "string",
  "author": "string",
  "email": "string",
  "has_custom_art": true,
  "art": "string",
  "art_updated_at": 0,
  "guid": "string",
  "is_published": true,
  "episodes": 0,
  "categories": [
    {
      "category": "string",
      "text": "string",
      "title": "string",
      "subtitle": "string"
    }
  ]
}

{
  "code": 500,
  "type": "NotLoggedInException",
  "message": "Error description.",
  "formatted_message": "<b>Error description.</b><br>Detailed error text.",
  "extra_data": [],
  "success": false
}

{
  "code": 500,
  "type": "NotLoggedInException",
  "message": "Error description.",
  "formatted_message": "<b>Error description.</b><br>Detailed error text.",
  "extra_data": [],
  "success": false
}

{
  "code": 500,
  "type": "NotLoggedInException",
  "message": "Error description.",
  "formatted_message": "<b>Error description.</b><br>Detailed error text.",
  "extra_data": [],
  "success": false
}

Body

application/json

idstring

storage_location_idinteger

sourcestring

playlist_idinteger | null

playlist_auto_publishboolean

titlestring

linkstring | null

descriptionstring

description_shortstring

explicitboolean

is_enabledboolean

branding_configPodcastBrandingConfiguration

Show child attributes

public_custom_htmlstring | null

enable_op3_prefixboolean

languagestring

language_namestring

authorstring

emailstring

has_custom_artboolean

artstring

art_updated_atinteger

guidstring

The UUIDv5 global unique identifier for this podcast, based on its RSS feed URL.

is_publishedboolean

episodesinteger

categoriesArray<Api_PodcastCategory>

Show child attributes

categorystring

textstring

titlestring

subtitlestring | null

Parameters

station_idinteger | stringrequiredpath

Response

200OKHasLinks & object

Success

Response fields application/json

linksobjectread only

Show child attributes

[key: string]string

idstring

storage_location_idinteger

sourcestring

playlist_idinteger | null

playlist_auto_publishboolean

titlestring

linkstring | null

descriptionstring

description_shortstring

explicitboolean

is_enabledboolean

branding_configPodcastBrandingConfiguration

Show child attributes

public_custom_htmlstring | null

enable_op3_prefixboolean

languagestring

language_namestring

authorstring

emailstring

has_custom_artboolean

artstring

art_updated_atinteger

guidstring

The UUIDv5 global unique identifier for this podcast, based on its RSS feed URL.

is_publishedboolean

episodesinteger

categoriesArray<Api_PodcastCategory>

Show child attributes

categorystring

textstring

titlestring

subtitlestring | null

403ForbiddenApi_Error

Access denied.

Response fields application/json

codeintegerrequired

The numeric code of the error.

Example

typestringrequired

The programmatic class of error.

Example

NotLoggedInException

messagestringrequired

The text description of the error.

Example

Error description.

formatted_messagestring | nullrequired

The HTML-formatted text description of the error.

Example

<b>Error description.</b><br>Detailed error text.

extra_dataArray<any>required

Stack traces and other supplemental data.

successbooleanrequired

Used for API calls that expect an \Entity\Api\Status type response.

Example

false

404Not FoundApi_Error

Record not found.

Response fields application/json

codeintegerrequired

The numeric code of the error.

Example

typestringrequired

The programmatic class of error.

Example

NotLoggedInException

messagestringrequired

The text description of the error.

Example

Error description.

formatted_messagestring | nullrequired

The HTML-formatted text description of the error.

Example

<b>Error description.</b><br>Detailed error text.

extra_dataArray<any>required

Stack traces and other supplemental data.

successbooleanrequired

Used for API calls that expect an \Entity\Api\Status type response.

Example

false

500Internal Server ErrorApi_Error

A generic exception has occurred.

Response fields application/json

codeintegerrequired

The numeric code of the error.

Example

typestringrequired

The programmatic class of error.

Example

NotLoggedInException

messagestringrequired

The text description of the error.

Example

Error description.

formatted_messagestring | nullrequired

The HTML-formatted text description of the error.

Example

<b>Error description.</b><br>Detailed error text.

extra_dataArray<any>required

Stack traces and other supplemental data.

successbooleanrequired

Used for API calls that expect an \Entity\Api\Status type response.

Example

false

Authorization

ApiKeyapiKey in header

Docs by Sourcey