Create Campaign Ads Batch

POST

/ad-campaigns/{campaign_id}/ads/batch

• Production
• QA

Add several ads at once.

Returns status="partial" when any individual ad failed, with per-ad outcomes in results. Inspect those rather than treating a 200 as total success — one creative rejected on policy does not stop its siblings.

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 several ads at once — “launch these four creatives as four ads”.

Partial success is expected: one creative rejected on policy does not stop the others, and the response reports each outcome separately.

object

ads

required

Array<object>

>= 1 items <= 20 items

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

200

Successful Response

object

data

required

object

campaign_id

required

integer

failed

required

integer

platform

Any of:

string

string

null

null

requested

required

integer

results

required

Array<object>

object

ad

Any of:

AdResponse

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

null

null

error

Any of:

string

string

null

null

index

required

integer

status

required

string

status

required

Ok | partial — never render success off a 200 alone

string

succeeded

required

integer

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