Podcasts
Create a podcast
Create a new podcast with metadata only (no episode generation).
Use POST /v1/podcasts/generate to create a podcast and generate
episodes in one step, or use this endpoint for manual podcast creation.
A cover image is automatically generated in the background.
The image_url field will be null in the response and populated
once generation completes. Use GET /v1/podcasts/{id} to check,
or upload your own via PUT /v1/podcasts/{id}/image.
Authorization
BearerAuth AuthorizationBearer <token>
Jellypod API key. Create and manage keys from the Jellypod dashboard under Settings ā API Keys.
In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://api.jellypod.com/v1/podcasts" \ -H "Content-Type: application/json" \ -d '{ "title": "string", "host_ids": [ "string" ] }'{
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"title": "The AI Revolution",
"description": "A deep dive into how artificial intelligence is transforming industries.",
"image_url": null,
"host_ids": [
"xK9mQ2pL"
],
"languages": [
"en"
],
"show_order": "episodic",
"show_visibility": "unlisted",
"url": "https://the-ai-revolution-a1b2c3.jellypod.com",
"rss_feed_url": "https://the-ai-revolution-a1b2c3.jellypod.com/rss.xml",
"episode_ids": [
"d4e5f6a7-b8c9-0123-def4-567890abcdef"
],
"created_at": "2026-03-01T10:00:00.000Z",
"updated_at": "2026-03-01T10:00:30.000Z"
}
}{
"error": {
"code": "bad_request",
"message": "string",
"request_id": "string",
"details": [
{
"field": "string",
"message": "string"
}
]
}
}{
"error": {
"code": "bad_request",
"message": "string",
"request_id": "string",
"details": [
{
"field": "string",
"message": "string"
}
]
}
}{
"error": {
"code": "bad_request",
"message": "string",
"request_id": "string",
"details": [
{
"field": "string",
"message": "string"
}
]
}
}{
"error": {
"code": "bad_request",
"message": "string",
"request_id": "string",
"details": [
{
"field": "string",
"message": "string"
}
]
}
}Was this page helpful?