AdnovaDocs
Ad Launcher

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, adSets
  • organicPostDetails.postId
  • organicPostDetails.sourceType — facebook or instagram
  • adProfiles — the post's own publishing identity: facebook_page_id and instagram_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

  • organicPostDetails replaces creativeDetails — they're mutually exclusive. Don't send creativeDetails.
  • 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 — set true if 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.