Launch Ad Campaign
POST /audience-syncs/{config_id}/launch
Launch a paid campaign on the platform, targeting this sync’s audience.
THIS SPENDS THE CUSTOMER’S ADVERTISING BUDGET. The campaign goes live with
daily_budget in currency from start_date, and the platform starts
charging as soon as it serves. spend_cap and auto_pause_at are the
guard rails; set them. Upload the creative first with
POST /ad-campaigns/images.
READ status IN THE BODY. The app answers a refused launch (campaign not
found, the platform rejecting it) with a 200 whose status is error, and
this route passes that through unchanged rather than guessing an HTTP code
for it. A launch can also partly succeed - the platform accepts the campaign
and then rejects a creative in review - so follow up with
POST /ad-campaigns/{campaign_id}/status-refresh.
Authorizations
Parameters
Path Parameters
The sync config whose audience the campaign targets.
The sync config whose audience the campaign targets.
Header Parameters
Request Body required
object
Google Search with ad groups only: launch even though a bid is above the daily budget
Google Search with ad groups only: consent for graph8 to create a conversion action when the strategy needs one
object
Responses
200
Successful Response
object
One ad-platform object, or one handler response.
object
object
Whether there are more pages
Items per page
Current page number (1-indexed)
Total number of items
422
Validation Error