Sign in
Ad Accounts

Create a negative keyword list

Creates one Google Ads shared negative keyword list with optional initial keywords in a single atomic mutation. Daily quota is reserved for every mutate item, so large batches may return 429 before any change. This operation is not idempotent. The list is not attached to any campaign.

post/v1/ads/accounts/negative-keyword-lists

Request body

accountIdstring required

Zernio SocialAccount id.

adAccountIdstring

Platform ad account ID (Google customer ID, digits only). Required when the connection has multiple customers.

customerIdstring

Alias of adAccountId, kept for existing callers

platform'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai'

Optional courtesy field. The resolved account or campaign determines support; other platforms return 501.

namestring required

Nonempty list name, trimmed before use.

Response

Successful response.

idstring

New shared set id.

resourceNamestring

New shared set resource name.

createdinteger

Number of initial keyword criteria created.

customerIdstring

Resolved Google Ads customer id.

Changes