Campaigns

Create a campaign

Changed on

Creates the campaign exactly as the app's New campaign form does. Audiences you pass are attached and start generating targeting right away. Nothing is sent to Google Ads.

Scope: campaigns:write.

Send an Idempotency-Key header to make retries safe.

post/campaigns

Request

Headers

Idempotency-Keystring

Any unique string. Repeating a request with the same key returns the first result instead of doing it twice.

Request body

namestring required
campaignType'SEARCH' | 'DEMAND_GEN' | 'VIDEO' | 'DISPLAY' required

Google Ads campaign type.

objectivestring

What the campaign should achieve and for whom. Drives targeting.

brandIdstring

Fills the brand's name, website and description into the campaign.

audienceIdsstring[]
googleAdsCustomerIdstring

A connected Google Ads account to create it in later. See List Google Ads accounts.

budgetnumber

Daily budget.

biddingStrategy'MAXIMIZE_CONVERSIONS' | 'MAXIMIZE_CONVERSION_VALUE' | 'TARGET_CPA' | 'TARGET_ROAS' | 'TARGET_CPC' | 'TARGET_SPEND' | 'MANUAL_CPC'

Google Ads bidding strategy.

industrystring
languagestring

Language code. Default en.

locationsstring[]

Country or region codes, e.g. ["US"]. Default ["US"].

successMetricsstring[]

Response

Success

idstring required
namestring required
statusstring required

draft, loading (collecting data), ready or error.

objectivestring required
brandIdstring nullable required
industrystring required
languagestring required
locationsstring[] required
successMetricsstring[] required
campaignTypestring nullable required
budgetnumber nullable required

In the account's currency.

budgetType'daily' | 'total' nullable required
endDatestring nullable required
biddingStrategystring nullable required
targetCpanumber nullable required
targetRoasnumber nullable required
urlstring required

Opens the campaign in Fandom.

createdAtstring nullable required
updatedAtstring nullable required

Changes