---
title: "Create a podcast"
method: POST
path: "/v1/podcasts"
tags: ["Podcasts"]
---

# Create a podcast

`POST /v1/podcasts`

## Request

- Base URL: `https://api.jellypod.com`
- URL: `https://api.jellypod.com/v1/podcasts`
- Auth: HTTP bearer

## Request body

- CreatePodcastInput: Fields required to create a podcast.
  - `author` string, nullable: Credited author for itunes:author and itunes:owner. Null or blank credits the podcast title.
  - `description` string: Plain text or HTML. Plain text is returned inside <p> tags.
  - `episode_order` 'episodic' | 'serial'
  - `host_ids` string[], required
  - `language` string
  - `primary_category` 'Arts' | 'Books' | 'Design' | 'Fashion & Beauty' | 'Food' | 'Performing Arts' | 'Visual Arts' | 'Business' | 'Careers' | 'Entrepreneurship' | 'Investing' | 'Management' | 'Marketing' | 'Non-Profit' | 'Comedy' | 'Comedy Interviews' | 'Improv' | 'Stand-Up' | 'Education' | 'Courses' | 'How To' | 'Language Learning' | 'Self-Improvement' | 'Fiction' | 'Comedy Fiction' | 'Drama' | 'Science Fiction' | 'Government' | 'History' | 'Health & Fitness' | 'Alternative Health' | 'Fitness' | 'Medicine' | 'Mental Health' | 'Nutrition' | 'Sexuality' | 'Kids & Family' | 'Education for Kids' | 'Parenting' | 'Pets & Animals' | 'Stories for Kids' | 'Leisure' | 'Animation & Manga' | 'Automotive' | 'Aviation' | 'Crafts' | 'Games' | 'Hobbies' | 'Home & Garden' | 'Video Games' | 'Music' | 'Music Commentary' | 'Music History' | 'Music Interviews' | 'News' | 'Business News' | 'Daily News' | 'Entertainment News' | 'News Commentary' | 'Politics' | 'Sports News' | 'Tech News' | 'Religion & Spirituality' | 'Buddhism' | 'Christianity' | 'Hinduism' | 'Islam' | 'Judaism' | 'Religion' | 'Spirituality' | 'Science' | 'Astronomy' | 'Chemistry' | 'Earth Sciences' | 'Life Sciences' | 'Mathematics' | 'Natural Sciences' | 'Nature' | 'Physics' | 'Social Sciences' | 'Society & Culture' | 'Documentary' | 'Personal Journals' | 'Philosophy' | 'Places & Travel' | 'Relationships' | 'Sports' | 'Baseball' | 'Basketball' | 'Cricket' | 'Fantasy Sports' | 'Football' | 'Golf' | 'Hockey' | 'Rugby' | 'Running' | 'Soccer' | 'Swimming' | 'Tennis' | 'Volleyball' | 'Wilderness' | 'Wrestling' | 'Technology' | 'True Crime' | 'TV & Film' | 'After Shows' | 'Film History' | 'Film Interviews' | 'Film Reviews' | 'TV Reviews': Apple Podcasts category or subcategory. The RSS feed nests a subcategory under its parent category.
  - `secondary_category` 'Arts' | 'Books' | 'Design' | 'Fashion & Beauty' | 'Food' | 'Performing Arts' | 'Visual Arts' | 'Business' | 'Careers' | 'Entrepreneurship' | 'Investing' | 'Management' | 'Marketing' | 'Non-Profit' | 'Comedy' | 'Comedy Interviews' | 'Improv' | 'Stand-Up' | 'Education' | 'Courses' | 'How To' | 'Language Learning' | 'Self-Improvement' | 'Fiction' | 'Comedy Fiction' | 'Drama' | 'Science Fiction' | 'Government' | 'History' | 'Health & Fitness' | 'Alternative Health' | 'Fitness' | 'Medicine' | 'Mental Health' | 'Nutrition' | 'Sexuality' | 'Kids & Family' | 'Education for Kids' | 'Parenting' | 'Pets & Animals' | 'Stories for Kids' | 'Leisure' | 'Animation & Manga' | 'Automotive' | 'Aviation' | 'Crafts' | 'Games' | 'Hobbies' | 'Home & Garden' | 'Video Games' | 'Music' | 'Music Commentary' | 'Music History' | 'Music Interviews' | 'News' | 'Business News' | 'Daily News' | 'Entertainment News' | 'News Commentary' | 'Politics' | 'Sports News' | 'Tech News' | 'Religion & Spirituality' | 'Buddhism' | 'Christianity' | 'Hinduism' | 'Islam' | 'Judaism' | 'Religion' | 'Spirituality' | 'Science' | 'Astronomy' | 'Chemistry' | 'Earth Sciences' | 'Life Sciences' | 'Mathematics' | 'Natural Sciences' | 'Nature' | 'Physics' | 'Social Sciences' | 'Society & Culture' | 'Documentary' | 'Personal Journals' | 'Philosophy' | 'Places & Travel' | 'Relationships' | 'Sports' | 'Baseball' | 'Basketball' | 'Cricket' | 'Fantasy Sports' | 'Football' | 'Golf' | 'Hockey' | 'Rugby' | 'Running' | 'Soccer' | 'Swimming' | 'Tennis' | 'Volleyball' | 'Wilderness' | 'Wrestling' | 'Technology' | 'True Crime' | 'TV & Film' | 'After Shows' | 'Film History' | 'Film Interviews' | 'Film Reviews' | 'TV Reviews' | 'null', nullable: Optional second Apple Podcasts category or subcategory.
  - `title` string, required
  - `visibility` 'public' | 'private'

## Response `201`

Podcast created

- object
  - `data` Podcast, required: A podcast in your library with metadata, hosts, languages, and feed URLs.
    - `author` string, nullable, required
    - `created_at` string, required
    - `description` string, required
    - `episode_count` integer, required: Number of episodes that belong to this podcast.
    - `episode_order` 'episodic' | 'serial', required: Episode ordering: `episodic` (standalone) or `serial` (sequential). Always returned lowercase.
    - `host_ids` string[], nullable, required
    - `id` string, uuid, required
    - `image_url` string, nullable, required
    - `languages` string[], required
    - `primary_category` string, nullable, required
    - `rss_feed_url` string, nullable, required: Public RSS feed URL. Null while podcast visibility is private.
    - `secondary_category` string, nullable, required
    - `title` string, required
    - `updated_at` string, required
    - `url` string, nullable, required: Public podcast website URL. Null while podcast visibility is private.
    - `visibility` 'public' | 'private' | 'unlisted' | 'null', nullable, required: Visibility. Always returned lowercase.

## Other responses

- `400`: Validation failed or malformed request.
- `401`: Missing or invalid API key.
- `403`: Authenticated, but this API key does not have access to this resource.
- `404`: Resource not found.
- `415`: Request `Content-Type` is not supported for this endpoint.
- `429`: Rate limit exceeded. Response includes `Retry-After`, `RateLimit`, and `RateLimit-Policy` headers (IETF draft).
- `500`: Internal server error.

---

[API](https://skmtc.dev/jellypod/apis/jellypod-api.md) · [All operations](https://skmtc.dev/jellypod/apis/jellypod-api/llms.txt) · [OpenAPI document](https://skmtc.dev/jellypod/apis/jellypod-api/revisions/ba945de68cf7?raw)