Podcasts

Create a podcast

Create a podcast. Returns JSON unless otherwise noted.

Authentication

Authorizationbearer token

Requires podcasts.write — Create and update podcasts, seasons, and episodes.

Body parameters

application/json

titlestringrequired

The public podcast title.

descriptionstringrequired

A plain-text or HTML show description.

categorystringrequired

The primary Apple Podcasts category.

showTypeEPISODIC | SERIALrequired

Controls episode ordering in compatible podcast clients.

languagestring

BCP 47 language code.

explicitboolean

Whether the show contains explicit material.

Responses

201The resource was created

400The request is invalid

401Authentication is missing or invalid

403The token does not have the required scope

429Rate limit exceeded

const response = await fetch('https://api.ufw.dev/v1/podcasts', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "title": "The UFW Podcast",
    "description": "Independent conversations about software.",
    "category": "Technology",
    "showType": "EPISODIC",
    "language": "en",
    "explicit": false
  }),
});

const data = await response.json();

Response201

{
  "id": "9f1c0f5e-6b1a-4a2e-9c3d-8f0e5b7a1d24",
  "feed_url": "https://api.ufw.dev/v1/podcasts/feeds/9f1c0f5e-6b1a-4a2e-9c3d-8f0e5b7a1d24"
}