Skip to main content

PodcastCreateRequest

Request body to create a podcast. The network comes from the path. title, feed_url and primary_contact are required. Platform-owned fields (opt_in_status, primary_voice_id, lifecycle status, version, info) are never accepted --- the opt-in flow owns them. RSS auto-import from feed_url is a deferred follow-up.

titlestringnullable

Display title of the podcast. Required.

Example: The Daily Tech
feed_urlstringnullable

URL of the podcast's RSS feed. Required.

Example: https://feeds.example.com/the-daily-tech.xml
descriptionstringnullable

Short description of the podcast.

Example: A daily look at the latest in technology.
linkstringnullable

URL of the podcast's public website or landing page.

Example: https://example.com/podcasts/the-daily-tech
image_urlstringnullable

URL of the podcast's cover artwork image.

Example: https://cdn.example.com/the-daily-tech/cover.jpg
languagestringnullable

Primary language of the podcast as an ISO 639-1 code.

Example: en
categoriesstring[]nullable

Content categories the podcast belongs to.

primary_contact objectnullable

The primary contact for this podcast. Required.

emailstringnullable

Email address of the contact (required)

Example: ops@example.com
first_namestringnullable

First name of the contact (required)

Example: Jane
last_namestringnullable

Last name of the contact (required)

Example: Doe
rolestringnullable

Optional free-form role or title of the contact

Example: Head of Partnerships
contacts object[]nullable

Additional contacts associated with this podcast.

  • Array [
    • emailstringnullable

    Email address of the contact (required)

    Example: ops@example.com
    first_namestringnullable

    First name of the contact (required)

    Example: Jane
    last_namestringnullable

    Last name of the contact (required)

    Example: Doe
    rolestringnullable

    Optional free-form role or title of the contact

    Example: Head of Partnerships
  • ]
    • external_ids objectnullable

    External system identifiers keyed by system name.

    property name*string
    downloads_per_monthint64nullable

    Estimated number of episode downloads per month.

    Example: 125000
    PodcastCreateRequest
    {
      "title": "The Daily Tech",
      "feed_url": "https://feeds.example.com/the-daily-tech.xml",
      "description": "A daily look at the latest in technology.",
      "link": "https://example.com/podcasts/the-daily-tech",
      "image_url": "https://cdn.example.com/the-daily-tech/cover.jpg",
      "language": "en",
      "categories": [
        "string"
      ],
      "primary_contact": {
        "email": "ops@example.com",
        "first_name": "Jane",
        "last_name": "Doe",
        "role": "Head of Partnerships"
      },
      "contacts": [
        {
          "email": "ops@example.com",
          "first_name": "Jane",
          "last_name": "Doe",
          "role": "Head of Partnerships"
        }
      ],
      "external_ids": {},
      "downloads_per_month": 125000
    }