Appearance
Facebook partnership ads with a new ad creative
Updated: Jun 26, 2026
You can use branded content media, such as a post tagged as branded content by a creator, to create partnership ads.
This document shows you how to:
- Create an ad with yourself as the primary identity and the creator as the secondary identity
- Create an ad with the creator as the primary identity and you as the secondary identity
Before you start
Review the requirements for creating partnership ads.
Upload a new creative
- Upload and manage images to later use in an ad creative. Image formats, sizes, and design guidelines depend upon your type of ad; see Ads Guide and Image Crop for more information.
- To upload videos, follow the Video API publishing guidelines.
Retrieve the creator's Facebook Page ID
You can fetch a creator's Facebook Page ID using the Pages Search API, or by asking the creator to provide their Facebook Page's ID.
You can also go to the Facebook Page and find under About > Page Transparency.
Create an ad with yourself as the primary identity
Send a POST request to the /act_{ad-account-id}/adcreatives endpoint with the page_id field set to the advertiser's Facebook Page ID for the primary identity. You also pass either the sponsor_id (Instagram) or the sponsor_page_id (Facebook) fields, or both, to be the secondary identity of the partnership ad.
Note: If you only provide either the sponsor_id or the sponsor_page_id, Meta automatically links the associated Instagram user ID or Facebook Page ID. If there is no hard link between the Instagram and Facebook accounts, Meta does not deliver the ad to that specific platform.
Example request
{
"degrees_of_freedom_spec": { // required field to be passed
"creative_features_spec": {
"standard_enhancements": { // required field to be passed
"action_metadata": {
"type": "DEFAULT"
},
"enroll_status": "OPT_IN"
}
},
"degrees_of_freedom_type": "USER_ENROLLED_AUTOFLOW"
},
"facebook_branded_content": {
"sponsor_page_id": "255033446395141" // Creator Page ID (test rithiky brand)
},
"object_story_spec": {
"page_id": "110001241469329", // Advertiser Page ID (test vitaan brand new)
"link_data": {
"attachment_style": "link",
"call_to_action": {
"type": "LEARN_MORE"
},
"link": "www.instagram.com", // sample url
"image_hash": "1b7a65956006e9941608b3914d3964f5" //sample image hash
}
}
}Example response
{
"id": <CREATIVE_ID>
}Example ad
The example request for the advertiser as the primary identity produces the ad shown in the following image.
Create an ad with the creator as the primary identity
Send a POST request to the /act_{ad-account-id}/adcreatives endpoint with the page_id field set to the creator's Facebook Page ID.
If the creator does not have an existing Facebook Page, you can pass your Page ID as the page_id field, but Meta does not deliver the ad to Facebook.
Note: Meta automatically derives the Instagram user ID from the Facebook Page ID you pass in the object_story_spec field.
Example request
{
"degrees_of_freedom_spec": { // required field to be passed
"creative_features_spec": {
"standard_enhancements": { // required field to be passed
"action_metadata": {
"type": "DEFAULT"
},
"enroll_status": "OPT_IN"
}
},
"degrees_of_freedom_type": "USER_ENROLLED_AUTOFLOW"
},
"facebook_branded_content": {
"sponsor_page_id": "255033446395141" // Advertiser Page ID (test vitaan brand)
},
"object_story_spec": {
"page_id": "255033446395141", // Creator Page ID (test rithiky brand)
"link_data": {
"attachment_style": "link",
"call_to_action": {
"type": "LEARN_MORE"
},
"link": "www.instagram.com", // sample url
"image_hash": "1b7a65956006e9941608b3914d3964f5" //sample image hash
}
}
}Example response
{
"id": <CREATIVE_ID>
}Example ad
The sample request above produces the following ad.
Create an ad
To create an ad with the ad creative you provided using one of the sections above, 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 ad creative ID you received, and the status initially set PAUSED.
Example request
curl -X POST \
-F 'name": "My Ad's 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
On success, the API returns the ad ID.
{
"id": <AD_ID>
}You can use the returned ad ID to publish your ad.