Skip to main content

PageResponse_CreativeDto_

A single page of results. nextCursor is an opaque token to pass back as ?cursor= to fetch the following page; null means there are no more results.

items object[]required
  • Array [
    • 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.
  • ]
    • next_cursorstringnullable
    PageResponse_CreativeDto_
    {
      "items": [
        {
          "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."
        }
      ],
      "next_cursor": "string"
    }