You can boost more types of organic Facebook content as partnership ads, including branded content with the paid partnership label, Facebook Collab posts, mentions, page tags, and other content without the paid partnership label. You can also use an ad code or an existing post ID to create partnership ads for all types of content.

This document shows you how to:

Retrieve Facebook branded content posts

Create partnership ads using a branded content post

Create partnership ads using a partnership ad code

Before You Begin

Review the requirements for creating partnership ads.

Permissions

facebook_branded_content_ads_brand

Retrieve Facebook Branded Content Posts

To find all the posts that you are tagged in that are available to be used in an ad, send a GET request to the /partnership-ads/{sponsor-page-id}/advertisable-posts endpoint where {sponsor-page-id} is the delegate Facebook Page ID for your brand’s Facebook Page.

Parameters

Name	Description
`ad_code`	Optional. The ad code shared by the creator you are working with.
`Authorization`	Required. Bearer token for the authentication header.
`creator_page_id`	Optional for Facebook partnership ads. To find branded content for a specific creator for your brand, include the `creator_page_id` field set to the creator’s Facebook Page ID.
`creator_username`	Optional. To find branded content from a specific creator for your brand, include the `creator_username` field set to the username of the creator.
`only_fetch_allowlisted`	Optional. Only retrieve media from creators that have been allowlisted. Note: The default value is `false` to allow you to fetch more data and for API performance.
`permalinks`	Optional. An array of Facebook post permalinks that can be obtained from the creator that you are working with. Example: `['https://www.facebook.com/59961010139648/posts/pfbid02oBGjW2VuqvGomxTS6yHmdNKdjEerWn5zFgXWV4RRAibDkbWaYJAH9HEmrwgZnWFvl/','https://www.facebook.com/59961010139648/videos/17902564192200/']`
`range`	Optional for Facebook partnership ads. Range header for pagination in the format of `post=<START>-<END>`. Default value: `post=0-10000`

Example request

curl -i -X GET \
  -H 'Authorization: Bearer <AUTH_TOKEN>' \
  -H 'range: <RANGE_HEADER>' \
  -d 'creator_username=<CREATOR_USERNAME>' \
  -d 'creator_page_id=<CREATOR_PAGE_ID>' \
  -d 'permalinks=[<PERMALINK1>,<PERMALINK2>...]' \
  -d 'ad_code=<AD_CODE>' \
'https://api.facebook.com/partnership-ads/<SPONSOR_PAGE_ID>/advertisable-posts'

Example response

Upon success, your app will receive a list of posts containing the post IDs, eligibility errors (if any), permalinks, whether you have permissions to boost the posts, and the owner IDs of the posts that can be used in ads.

[
  {
    "post_id": 48602429468091,
    "owner_page_id": 31202392748498,
    "permalink": "https://www.facebook.com/59961010139648/posts/pfbid02oBGjW2VuqvGomxTS6yHmdNKdjEerWn5zFgXWV4RRAibDkbWaYJAH9HEmrwgZnWFvl/",
    "has_permission_for_partnership_ad": true,
    "eligibility_errors": []
  },
  {
    "post_id": 17902564192200,
    "owner_page_id": 31202392748498,
    "permalink": "https://www.facebook.com/59961010139648/videos/17902564192200/",
    "has_permission_for_partnership_ad": true,
    "eligibility_errors": []
  },
  {
    "post_id": 44102421656818,
    "owner_page_id": 31202392748498,
    "permalink": "https://www.facebook.com/59961010139648/videos/44102421656818/",
    "has_permission_for_partnership_ad": true,
    "eligibility_errors": []
  },
  {
    "post_id": 30902420582901,
    "owner_page_id": 31202392748498,
    "permalink": "https://www.facebook.com/59961010139648/videos/30902420582901/",
    "has_permission_for_partnership_ad": true,
    "eligibility_errors": ["Reels that use copyrighted music can't be boosted as ads."]
  }
]

Create an Ad Creative

Parameters

Name	Description
`branded_content` JSON object	An object containing information about the partnership ad. `facebook_boost_post_access_token` — A Facebook partnership ad code to create the ad. `ad_format` — Sets the identities to display in the ad. Values: `1` (default): Renders both provided identities. This is the default value if nothing is passed in. `2`: Renders only the first identity provided. `3`: Allows the system to automatically optimize for the most performant option between single identity (`2`) and dual identity (`1`). Note: This currently only optimizes on Instagram.
`facebook_branded_content` JSON object	An object containing the required parameters for Facebook partnership ads.
`instagram_branded_content` JSON object	An object containing the required parameters for Instagram partnership ads.
`object_story_id` string	A combination of the creator’s Facebook delegate Page ID and post ID delimited by an underscore ( _ ). Use this parameter when creating ads from Facebook content. Example: `"<CREATOR_PAGE_ID>_<CREATOR_POST_ID>"`

Using the Facebook post ID

Using a Facebook post ID requires the object_story_id parameter, which is a combination of the creator’s Facebook Page ID and Facebook post ID.

Example request

curl -X POST \
  -F 'object_story_id="<CREATOR_PAGE_ID>_<CREATOR_POST_ID>"' \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'facebook_branded_content={
    "sponsor_page_id": "<BRAND_PAGE_ID>"
  }' \
  -F 'instagram_branded_content={
    "sponsor_id": "<BRAND_IG_ID>"
  }' \
  -F 'branded_content={
    "ad_format": "<AD_FORMAT_TYPE>"
  }' \
'https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adcreatives'

Example response

Upon success, your app will receive the ad creative ID to use in the ad.

{
  "id": "<CREATIVE_ID>"
}

Using a Facebook partnership ad code

Send a POST request to the /act_{ad-account-id}/adcreatives endpoint with the facebook_boost_post_access_token provided by the creator.

Example request

curl -X POST \
  -F 'branded_content={
       "facebook_boost_post_access_token": "<AD_CODE>",
       "ad_format": "<AD_FORMAT_TYPE>"
   }' \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'facebook_branded_content={
    "sponsor_page_id": "<BRAND_PAGE_ID>"
  }' \
  -F 'instagram_branded_content={
    "sponsor_id": "<BRAND_IG_ID>"
  }' \
'https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adcreatives'

Example response

Upon success, your app will receive the ad creative ID to use in the ad.

{
  "id": "<CREATIVE_ID>"
}

Create an ad

Send a POST request to the/act_{ad-account-id}/ads endpoint with the name field set to the name for your ad, the adset_id field set to your ad set ID, the creative field with the creative_id parameter set to the ID you received, and the status initially set PAUSED.

Example request

curl -X POST \
  -F 'name=Ad Name' \
  -F 'adset_id=<ADSET_ID>' \
  -F 'creative={"creative_id": "<CREATIVE_ID>"}' \
  -F 'status=PAUSED' \
  -F 'access_token=<ACCESS_TOKEN>' \
'https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/ads'

Example response

Upon success, your app will receive the ad ID.

{
  "id": "<AD_ID>"
}

You can use this ad ID to publish your ad.

Comments Moderation

You can moderate comments on a partnership ad using the /{comment-id} endpoint’s is_hidden parameter. This means you can moderate comments even when the post was created by another Page, without needing the creator to take action.

Note: This is only available for comments on Page posts.

To hide a comment, send a POST request to the /{comment-id} endpoint with is_hidden set to true. Setting is_hidden to false will unhide the comment.

See the Comment API reference for more information.

Example request

curl -X POST \
  -F "access_token=<ACCESS_TOKEN>" \
  -F "is_hidden=true" \
"https://graph.facebook.com/v25.0/<COMMENT_ID>"

Example response

{
  "success":true
}

Did you find this page helpful?