Copy page

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

Code
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

Code
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

POST /v1/campaigns/{campaign_token}/creatives

create Creative

Code
{"openapi":"3.0.3","info":{"title":"API V1","version":"v1"},"servers":[{"url":"https://{defaultHost}","variables":{"defaultHost":{"default":"api.adquick.com"}}}],"paths":{"/v1/campaigns/{campaign_token}/creatives":{"post":{"summary":"create Creative","parameters":[{"name":"campaign_token","in":"path","required":true,"schema":{"type":"string"}},{"name":"X-PARTNER-TOKEN","in":"header","schema":{"type":"string"}}],"responses":{"200":{"description":"successful","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"integer"},"programmatic_plan_id":{"type":"integer"},"upload_id":{"type":"integer"},"approved_at":{"type":"string","format":"date-time","nullable":true},"rejected_at":{"type":"string","format":"date-time","nullable":true},"created_at":{"type":"string","format":"date-time","minLength":1},"updated_at":{"type":"string","format":"date-time","minLength":1},"iab_category_id":{"type":"integer","nullable":true},"width":{"type":"string","minLength":1},"height":{"type":"string","minLength":1},"external_id":{"type":"string","minLength":1},"error_at":{"type":"string","format":"date-time","nullable":true},"deleted_at":{"type":"string","format":"date-time","nullable":true},"ignore_video":{"type":"string","format":"date-time","nullable":true},"error":{"type":"string","nullable":true},"resolution_id":{"type":"integer","nullable":true},"metadata":{"type":"object","nullable":true},"file_hash":{"type":"string","minLength":1},"dcm_tag":{"type":"string","nullable":true},"dcm_video_duration":{"type":"string","nullable":true},"dcm_video_bitrate":{"type":"string","nullable":true}},"required":["id","programmatic_plan_id","upload_id","created_at","updated_at","iab_category_id","width","height","external_id","resolution_id","file_hash"]}}}}},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"file_url":{"type":"string","minLength":1}},"required":["file_url"]}}}}}}}}

List Creatives

Code
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

Code
POST /creatives/:id/campaign/:campaign_id

Expects:
- creative_id
- campaign_id

Returns: Creative Object

Get Creative

Code
GET /creatives/:id

Expects:
- id

Returns: the creative object