Sign in
Ad Campaigns

Create a standalone ad group

Google Ads compliance row C.190: creates an ad group WITHOUT an ad, under an existing campaign. Ads join it later via adSetId on POST /v1/ads/create. Google only; every other platform returns 501.

Created PAUSED unless status: ACTIVE. The new ad group has no ad yet, so it will not appear in GET /v1/ads/tree (built purely from ads rows) until one is added; use GET /v1/ads/ad-sets to see it in the meantime.

Idempotency: send an Idempotency-Key header to make retries safe.

post/v1/ads/ad-sets

Headers

Idempotency-Keystring

Optional client-generated unique key (e.g. a UUID) that makes retries safe. Same key + same body replays the original response; same key + different body → 422; key still processing → 409. Only 2xx responses are stored, so a request that failed with a 4xx can be retried with a corrected body under the SAME key.

Request body

accountIdstring required

Zernio SocialAccount id owning the Google Ads connection.

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

Only "google" is implemented today; every other value returns 501.

campaignIdstring required

Google platform campaign ID (numeric) the ad group is created under.

namestring required
status'ACTIVE' | 'PAUSED'
adAccountIdstring

Platform ad account ID (Google customer ID, digits only). Only required when the connection has more than one.

customerIdstring

Alias of adAccountId, kept for existing callers

Response

Ad group created

adSetIdstring

Platform id of the new ad group

campaignIdstring

Changes