POST /ads/boost
Boost a published Facebook Page or Instagram post: creates campaign, ad set, creative (referencing the post, keeping its likes and comments) and ad, PAUSED unless status ACTIVE. Requires confirm: true
BearerAuthAuthorizationBearer <token>API key sk_...
application/json- body
accountId*stringConnected Facebook Page account id
adAccountId*stringAd account id (act_...)
confirm*booleanRequired (true) for anything that can spend: creates (campaign, ad set, ad, boost), status ACTIVE, budget, bid, schedule or targeting changes. Without it: 400 confirmation_required, nothing is created
postId?stringPostgale post id with a published Facebook or Instagram target
platformPostId?stringOr the Meta post id (Page post id or Instagram media id)
platform?string"facebook""instagram"instagramUserId?stringInstagram: business account id linked to the Page
name?stringgoal?string"engagement""engagement""traffic""awareness""video_views""lead_generation""conversions""app_promotion"budget*schedule?targeting?Simplified targeting, mapped to Meta's targeting spec
linkUrl?stringhttps link (with callToAction)
callToAction?stringLEARN_MORE, SHOP_NOW, SIGN_UP, MESSAGE_PAGE, WHATSAPP_MESSAGE, ...
specialAdCategories?array<string>status?stringPAUSED (default) or ACTIVE (only together with confirm: true)
"PAUSED""ACTIVE"{boost, mock}
application/json- response
boost?mock?booleancurl -X POST 'https://example.com/api/v1/ads/boost' \ -H 'Content-Type: application/json' \ -d '{ "accountId": "string", "adAccountId": "string", "confirm": true, "budget": { "amount": 100 }}'{ "boost": { "platform": "string", "platformPostId": "string", "status": "string", "campaignId": "string", "adSetId": "string", "creativeId": "string", "adId": "string" }, "mock": true}