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

FieldTypeRequiredDescription
namestringYesThe ad's name, and that of the created levels that don't have one.
statusstringNoThe tree's final state (active or paused). Everything is created paused and activated in the last step.
campaignobjectNo{"id": ...} for an existing campaign; without id, describes the one to be created.
adsetobjectYes{"id": ...} for an existing ad set; without id, describes the one to be created (budget, audience, optimization).
ad.post_idstringYesThe post to boost, from GET /ads/facebook_ads/posts.
ad.facebook_ads.instagram_account_idstringYesThe account that owns the post. Post ownership is proven through it.
ad.link_urlstringNoDestination URL, when applicable.
ad.call_to_actionstringNoThe 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.

Related

See everything you can do with Ads

See Connect applied to your product.

Try it for 15 days with no card, or walk our team through your use case.