Skip to main content

CreativeDto

A creative: an ad rendered in a podcast's host voice.

idstring

Unique identifier of the creative.

Example: 7Hb2Kp9QvL3mNx0R8tZ4
created_atdate-time

Timestamp when the creative was created.

Example: 2026-01-15T09:30:00Z
updated_atdate-time

Timestamp when the creative was last updated.

Example: 2026-01-15T09:30:00Z
podcast_idstring

Identifier of the podcast this creative belongs to.

Example: 3Fk8Lm2QrT5wYx9Bn1C
campaign_idstring

Identifier of the campaign this creative was generated for.

Example: 9Wq4Zx7NpR2kLb6Hm0D
offer_idstringnullable

Identifier of the offer this creative fulfills, when the creative was made from an offer.

Example: 5Tn1Yv8QcM4dKw3Pr7E
variant_idstringnullable

Identifier of the campaign ad-copy variant whose text the host read, when applicable.

Example: 2Bx6Rk9LtN5mZq8Wv4G
voice_idstring

Identifier of the voice clone used to synthesize the ad audio.

Example: 8Mp3Cq7VtL2nXw5Rk9H
statusstring

Creative lifecycle status. Audio generation is asynchronous: a creative starts pending, then becomes ready (audio_url populated) or failed (failure_reason populated). Poll this resource, or subscribe to the creative.ready / creative.failed webhook.

Possible values: [pending, ready, failed, approved, rejected, published, archived]

ad_copystring

The ad copy the host read for this creative.

Example: This episode is brought to you by Acme...
audio_urlstringnullable

Playable CDN URL of the generated ad audio, populated once the creative is ready.

Example: https://example.com/audio/creative.mp3
failure_reasonstringnullable

Client-safe reason audio generation failed, present only when status is failed. Recover by calling the creative regenerate action.

Example: Voice synthesis timed out; please try again.
CreativeDto
{
  "id": "7Hb2Kp9QvL3mNx0R8tZ4",
  "created_at": "2026-01-15T09:30:00Z",
  "updated_at": "2026-01-15T09:30:00Z",
  "podcast_id": "3Fk8Lm2QrT5wYx9Bn1C",
  "campaign_id": "9Wq4Zx7NpR2kLb6Hm0D",
  "offer_id": "5Tn1Yv8QcM4dKw3Pr7E",
  "variant_id": "2Bx6Rk9LtN5mZq8Wv4G",
  "voice_id": "8Mp3Cq7VtL2nXw5Rk9H",
  "status": "pending",
  "ad_copy": "This episode is brought to you by Acme...",
  "audio_url": "https://example.com/audio/creative.mp3",
  "failure_reason": "Voice synthesis timed out; please try again."
}