Multi-advertiser Ads

Updated: Jun 16, 2026

Multi-advertiser ads delivery will become OPT-IN by default beginning August 19, 2024. Partners will need to implement the multi-advertiser request in order to opt out of multi-advertiser ads. By default, Meta enrolls ads created on or after August 19 in multi-advertiser ads if they do not specify the enroll_status field within the contextual_multi_ads field.

Multi-advertiser ads show ads from multiple advertisers to people who are likely to continue shopping. Multi-advertiser ads are available for select placements on Facebook and Instagram. For more information, please visit the Business Help Center⁠.

API support for multi-advertiser ads

Multi-advertiser ads are supported in all versions of the Marketing API. Multi-advertiser ads support all campaign objectives and all ad formats across all available placements. The enroll_status field must be provided with either an OPT_IN or OPT_OUT value. Ads created on or after August 19, 2024 that do not specify the enroll_status field will be opted into multi-advertiser ads by default.

Ad creation

Request

curl -X POST \
  -F 'name="My creative title"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "link_data": {
         "link": "https://www.google.com",
         "image_hash": "<IMAGE_HASH>",
         "attachment_style": "link",
      }
     }' \
  -F 'contextual_multi_ads={
       "enroll_status": "OPT_IN"
     },'
  -F "access_token=<ACCESS_TOKEN>" \
   https://graph.facebook.com/v25.0/act_<AD_ACCOUNT_ID>/adcreatives

For more details, see Ad Creative.

Parameters

Name	Description
contextual_multi_ads	The enroll_status field can be set to OPT_IN or OPT_OUT. For more details, see Ad Creative Features Details, Reference.

Learn more

• Business Help Center
  • About multi-advertiser ads⁠
• Marketing API Reference
  • Ad Creative
  • Ad Account Ads