Creatives (coming soon)

Creatives represent the design files that the advertiser would like to appear on the ads.

We currently accept .jpg and .png file types.

The Creative Object

id: integer
name: string
url: string
advertiser_id
width: integer (width in pixels)
height: integer (height in pixels)
approvals: array
rejections: array
campaigns: array of campaing_id and approval status (PENDING | APPROVED | REJECTED)

Endpoints

Summary

POST /creatives #=> Create creative
GET /creatives #=>  List creatives
POST /creatives/:id/campaign/:campaign_id #=> Request approval for campaign
GET /creatives/:id #=> Get specific creative

Create Creative

create Creative

post

Path parameters

campaign_tokenstringrequired

Header parameters

X-PARTNER-TOKENstringoptional

Body

file_urlstring · min: 1required

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://www.example.com/v1/campaigns/{campaign_token}/creatives' \
  --header 'Content-Type: application/json' \
  --data '{
    "file_url": "text"
  }'

200

200

{
  "id": 1,
  "programmatic_plan_id": 1,
  "upload_id": 1,
  "approved_at": null,
  "rejected_at": null,
  "created_at": "2025-04-03",
  "updated_at": "2025-04-03",
  "iab_category_id": null,
  "width": "text",
  "height": "text",
  "external_id": "text",
  "error_at": null,
  "deleted_at": null,
  "ignore_video": null,
  "error": null,
  "resolution_id": null,
  "metadata": null,
  "file_hash": "text",
  "dcm_tag": null,
  "dcm_video_duration": null,
  "dcm_video_bitrate": null
}

successful

List Creatives

GET /creatives

Expects:
- advertiser_id (optional) #=> filters responses to only that advertiser

Returns: paginated array of creatives inside a "records" key

Request approval for campaign

POST /creatives/:id/campaign/:campaign_id

Expects:
- creative_id
- campaign_id

Returns: Creative Object

Get Creative

GET /creatives/:id

Expects:
- id

Returns: the creative object