Ads
Boost an Instagram post via API via API
POST /ads/boost turns an already published post into an ad, in the account your client connected. It is the same tree as POST /ads (campaign, ad set and ad), but the creative comes from the post: texts and media are not part of a boost. You don't implement the Meta API or go through app review.
The request
POST /api/ads/boost?customer_integration=<connection uuid>
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Idempotency-Key: <unique key>
{
"name": "Impulsionar post",
"status": "active",
"campaign": {
"facebook_ads": {
"objective": "engagement"
}
},
"adset": {
"budget": {
"amount": 20,
"type": "daily"
},
"targeting": {
"countries": [
"BR"
]
},
"facebook_ads": {
"optimization_goal": "post_engagement",
"billing_event": "impressions"
}
},
"ad": {
"post_id": "18191649508387596",
"facebook_ads": {
"instagram_account_id": "17841442920331135"
}
}
}What you can do
- List the posts that can be boosted in GET /ads/facebook_ads/posts.
- Boost a post creating a new campaign and ad set, or reusing existing ones with {"id": ...}.
- Set the ad set's budget, country, optimization and billing.
- Ask for status active to activate in the last step.
- Send optional link_url and call_to_action.
Rules and limits
- Everything is created paused and the requested status is applied in the last step.
- Idempotency-Key is required in the header; repeating with the same key returns 200 with Idempotent-Replay: true.
- ad.post_id comes from GET /ads/facebook_ads/posts. Without the source parameter, the list returns Instagram media, the only kind that works for boosting; with source=facebook the list is for discovery only.
- facebook_ads.instagram_account_id is required: post ownership is proven through it.
- The creative of a boosted ad can't be replaced afterwards: 422 boosted_creative_not_replaceable.
- If a step fails, what was created is undone and repeating with the same key resumes. The response is synchronous (201).
Main fields
| Field | Type | Required | Description |
|---|---|---|---|
| name | string | Yes | The ad's name, and that of the created levels that don't have one. |
| status | string | No | The tree's final state (active or paused). Everything is created paused and activated in the last step. |
| campaign | object | No | {"id": ...} for an existing campaign; without id, describes the one to be created. |
| adset | object | Yes | {"id": ...} for an existing ad set; without id, describes the one to be created (budget, audience, optimization). |
| ad.post_id | string | Yes | The post to boost, from GET /ads/facebook_ads/posts. |
| ad.facebook_ads.instagram_account_id | string | Yes | The account that owns the post. Post ownership is proven through it. |
| ad.link_url | string | No | Destination URL, when applicable. |
| ad.call_to_action | string | No | The ad's button. Values in GET /ads/options. |
Who it is for
Boost button in your product
Show the client's posts and, with one click, create the boost with the chosen budget and audience.
Automation for high-performing posts
When a post passes an engagement threshold in your metrics, create the boost automatically, paused, for approval.
Social media AI agent
The agent picks the post, proposes budget and audience and creates it paused for the manager to approve.
Works with
Meta Ads
Frequently asked questions
Can I boost Facebook posts?
The Facebook post list (source=facebook) is for discovery, not for boosting. Boosting uses Instagram media.
Can I change the text or image of a boosted ad?
No. The creative comes from the post, and replacing it returns 422 boosted_creative_not_replaceable.
Does the boost start spending right away?
Only if you send status active. Everything is created paused and activation is the last step.
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
