Skip to main content
POST
Typescript (SDK)

Authorizations

Authorization
string
header
required

API key in the format: Bearer {api_token}

Headers

Idempotency-Key
string

Makes this write safe to retry: a repeat with the same key replays the first response instead of creating a second resource. Scoped to the account, remembered for 24 hours; reusing a key with a different payload is an error.

Maximum string length: 255

Body

application/json

Keywords and where they go.

account_id
string
required

Connected Google Ads channel id (sacct_…).

keywords
object[]
required

Keywords to add, each with its match type.

ad_group_id
string

Platform ad group id. Required for keywords; for negatives send this or campaign_id.

campaign_id
string

Platform campaign id, for negatives only (adds to the campaign's negative list).

negative
boolean

true to add negatives instead of keywords. Defaults to false.

Response

What was added, with its level (ad_group or campaign).

What was added, with its level (ad_group or campaign).