Skip to main content

CreativeDto

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

idstring

Unique identifier of the creative.

Example: 7Hb2Kp9QvL3mNx0R8tZ4
createdAtdate-time

Timestamp when the creative was created.

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

Timestamp when the creative was last updated.

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

Identifier of the podcast this creative belongs to.

Example: 3Fk8Lm2QrT5wYx9Bn1C
campaignIdstring

Identifier of the campaign this creative was generated for.

Example: 9Wq4Zx7NpR2kLb6Hm0D
offerIdstringnullable

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

Example: 5Tn1Yv8QcM4dKw3Pr7E
variantIdstringnullable

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

Example: 2Bx6Rk9LtN5mZq8Wv4G
voiceIdstring

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]

adCopystring

The ad copy the host read for this creative.

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

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

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

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",
  "createdAt": "2026-01-15T09:30:00Z",
  "updatedAt": "2026-01-15T09:30:00Z",
  "podcastId": "3Fk8Lm2QrT5wYx9Bn1C",
  "campaignId": "9Wq4Zx7NpR2kLb6Hm0D",
  "offerId": "5Tn1Yv8QcM4dKw3Pr7E",
  "variantId": "2Bx6Rk9LtN5mZq8Wv4G",
  "voiceId": "8Mp3Cq7VtL2nXw5Rk9H",
  "status": "pending",
  "adCopy": "This episode is brought to you by Acme...",
  "audioUrl": "https://example.com/audio/creative.mp3",
  "failureReason": "Voice synthesis timed out; please try again."
}