Create a Creative

POST /creative

Use this method to create a creative.

Headers

Name	Value
Authorization	Basic <token>

Body

 {
  name: string,
  is_archived?: boolean,
  line_item: {
    id: number, // Mandatory, lineItemId (looks like 1234)
    name?: string
  },
  mediatype: string, //Options ('banner', 'video', 'native', 'audio')
  w?: number, //The width of the creative (required for banner)
  h?: number, //The height of the creative (required for banner)
  content: string,
  adomain: string, //Must be in this format 'domain.com'
  weight?: number, //Default value : 1
  comment?: string
}

Native creative content format

For native creatives (mediatype: 'native'), the content field must be a JSON string with the following structure:

{
  "title": "Ad Title",
  "img": "https://cdn.example.com/main-image.jpg",
  "icon": "https://cdn.example.com/icon.png",
  "description": "Ad description text",
  "brand": "Advertiser Name",
  "cta": "Learn More",
  "price": "$9.99",
  "clickUrl": "https://advertiser.com/landing-page"
}

All fields are optional. The DSP will match the creative against the publisher's native request assets and only include the fields that are requested. At minimum, provide the fields that match the required assets in the target publisher's native ad unit.

Field	Description
title	Ad headline text
img	URL for the main image
icon	URL for the icon/logo image
description	Body text or description
brand	Advertiser or sponsor name
cta	Call-to-action button text (e.g. "Learn More", "Buy Now")
price	Product price (e.g. "$9.99")
clickUrl	Landing page URL (wrapped with click tracking automatically)

#### **Response**

{% tabs %}
{% tab title="200 : OK Creative created" %}
```json
{
  "id": number,
  "name": string,
  "is_archived": boolean,
  "account": {
    "id": number,
    "name": string
  },
  "order": {
    "id": number,
    "name": string
  },
  "line_item": {
    "id": number,
    "name": string
  },
  "mediatype": string, //Options ('banner', 'video', 'native', 'audio')
  "w": number,
  "h": number,
  "content": string,
  "adomain": string,
  "weight": number,
  "comment": string
}

{% endtab %}

{% tab title="400 : Bad request no line item ID provided" %}

{
  "missingProperty": "lineItem.id"
}