Create Campaign Ad

POST

/ad-campaigns/{campaign_id}/ads

• Production
• QA

Add an ad to a campaign.

On a launched campaign the ad goes live immediately and begins consuming the campaign’s budget. This spends money, so the key needs ads:run.

Authorizations

• BearerAuth

Parameters

Path Parameters

campaign_id

required

Ad campaign ID

integer

Ad campaign ID

Header Parameters

X-Target-Org-Id

Any of:

string

string

null

null

Request Body ^required

Add one ad to a campaign.

Valid before launch (created with its siblings when the campaign launches) and after (pushed to the live campaign immediately). extra="forbid" so a field we never wired is a 422 rather than a silent success.

object

copy_assets

Any of:

object

object

key

additional properties

any

null

null

creative_image_url

Any of:

string

string

<= 500 characters

null

null

creative_image_url_portrait

Any of:

string

string

<= 500 characters

null

null

creative_image_url_square

Any of:

string

string

<= 500 characters

null

null

cta

Any of:

string

string

<= 50 characters

null

null

description

Any of:

string

string

<= 1000 characters

null

null

destination_url

Any of:

string

string

<= 500 characters

null

null

headline

Any of:

string

string

<= 255 characters

null

null

logo_image_url

Any of:

string

string

<= 500 characters

null

null

name

Any of:

string

string

<= 255 characters

null

null

primary_text

Any of:

string

string

<= 1000 characters

null

null

source_ad_creative_id

Any of:

string

string

<= 64 characters

null

null

Responses

201

Successful Response

object

data

required

One ad inside a campaign — a creative slot.

id is graph8’s, and it is stable: editing an ad almost always mints a new platform ad (LinkedIn creatives are immutable, and on Google only Search/RSA is mutable in place), but the slot and its measurement history survive that. Address an ad by this id, never by platform_ad_id.

object

approval_nuance

Any of:

string

string

null

null

campaign_id

required

integer

copy_assets

Any of:

object

object

key

additional properties

any

null

null

created_at

Any of:

string

string

null

null

creative_image_url

Any of:

string

string

null

null

creative_image_url_portrait

Any of:

string

string

null

null

creative_image_url_square

Any of:

string

string

null

null

cta

Any of:

string

string

null

null

description

Any of:

string

string

null

null

destination_url

Any of:

string

string

null

null

error_message

Any of:

string

string

null

null

headline

Any of:

string

string

null

null

id

Any of:

integer

integer

null

null

launched_at

Any of:

string

string

null

null

logo_image_url

Any of:

string

string

null

null

name

Any of:

string

string

null

null

platform_ad_id

Any of:

string

string

null

null

policy_topics

Any of:

Array<object>

Array<object>

object

key

additional properties

any

null

null

primary_text

Any of:

string

string

null

null

slot_index

required

integer

source_ad_creative_id

Any of:

string

string

null

null

status

required

Draft | launching | active | paused | archived | failed

string

pagination

Any of:

PaginationMeta

object

has_next

required

Whether there are more pages

boolean

limit

required

Items per page

integer

next_cursor

Any of:

string

string

null

null

page

required

Current page number (1-indexed)

integer

total

required

Total number of items

integer

null

null

422

Validation Error

object

detail

Array<object>

object

loc

required

Array

msg

required

string

type

required

string