Read campaign preparation status
Poll an existing deployment job. ready means prepared; live means delivery was activated. A failed or cancelled job may have created provider objects. lastError is a safe summary; detailed diagnostics remain in the owner dashboard.
Poll an existing deployment job. ready means prepared; live means delivery was activated. A failed or cancelled job may have created provider objects. lastError is a safe summary; detailed diagnostics remain in the owner dashboard.
Create a scoped key in Benjiads → Integrations. Sent only in Authorization.
In: header
Path Parameters
uuidResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/jobs/497f6eca-6276-4993-bfeb-53cbbbba6f08"{ "job": { "id": "string", "status": "string", "hold": "string", "attempts": 0, "adsWanted": 0, "adsCreated": 0, "campaignId": "string", "liveAt": "string", "nextRunAt": "string", "lastError": "string" }}Prepare a campaign POST
Queues preparation of Meta advertising objects with launch disabled. Background preparation sends operational Slack notifications with the business, budget and job outcome. Requires creative ownership and the licence checks; prefer launch_ads. Returns a job to poll. dailyBudgetCents is the TOTAL across locations.
Launch a prepared campaign POST
Starts ad delivery using the campaign's saved budget. Requires available ad money and completed preparation with required licences. Authorize the budget before calling.