Organic post ad
Boost an existing Facebook or Instagram post instead of uploading a creative.
An organic post ad promotes a post that already exists on a Facebook Page or Instagram account. There's no creative upload — you reference the post by id.
When to use this
A post is already performing organically and you want to put spend behind it.
Example body
POST /meta/launches
Every key applicable to an organic-post ad, with sample values. Required: organicPostDetails.postId + sourceType and adProfiles. The other top-level fields are the overridable allow-list (see below).
{
"adAccountId": "01H8Y4...",
"platform": "meta",
"ads": [
{
"adName": "Boost — Spring Reel",
"adSets": ["123456789012345"],
"organicPostDetails": {
"postId": "17912345678901234",
"sourceType": "instagram",
"mediaType": "VIDEO"
},
"adProfiles": {
"facebook_page_id": "123456789012345",
"instagram_account_id": "987654321098765"
},
"cta": "SHOP_NOW",
"webLink": "https://example.com/spring",
"utm": "utm_source=facebook&utm_medium=cpc&utm_campaign=spring",
"leadGenFormId": null,
"productSetId": null,
"adSchedule": { "startDate": "2026-06-01T00:00:00Z", "endDate": "2026-06-30T23:59:59Z" },
"promoCodeDetails": { "type": "manual", "manualCodes": ["SPRING40"] },
"aiMediaDisclosure": true
}
]
}Full schema: Create a launch.
Required fields
adName,adSetsorganicPostDetails.postIdorganicPostDetails.sourceType—facebookorinstagramadProfiles— the post's own publishing identity:facebook_page_idandinstagram_account_id. Pass the post's identity, not an arbitrary one.
cta and webLink are not required (the post carries its own copy and creative).
Overridable fields
The post is boosted as-is. Only this allow-list is applied; anything else is ignored:
adName, adSets, cta, webLink, utm, leadGenFormId, promoCodeDetails, adSchedule, productSetId, aiMediaDisclosure.
Taken from the post (not overridable): primary text, headline, description, display link, and the creative.
Field notes
organicPostDetailsreplacescreativeDetails— they're mutually exclusive. Don't sendcreativeDetails.adProfiles— used as the boost's publishing identity. See Required fields.mediaType—IMAGE/VIDEO/CAROUSEL_ALBUM. The launcher uses it to pick the right ad format.aiMediaDisclosure— settrueif the post contains media created or edited with AI. It is applied to the new ad creative that boosts the post.
Gotchas
- The post must be public/eligible for promotion and owned by an identity the ad account can advertise for.
- For Instagram video posts, Meta may require mirroring the video to the Facebook Page. The launcher handles this automatically.
