Multi-advertiser Ads

Multi-advertiser ads delivery will become OPT-IN by default beginning August 19, 2024. Partners must implement multi-advertiser ads before then so advertisers can opt out.

Multi-advertiser ads showcase ads from multiple advertisers, helping advertisers drive performance by reaching more people looking to go deeper in their shopping journey. 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, but all ad creation requests that are eligible for multi-advertiser ads must specify if the ad opts in to use it or not. 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.

Ad creation


curl -X POST \
  -F 'name="My creative title"' \
  -F 'object_story_spec={
       "page_id": "<PAGE_ID>",
       "link_data": {
         "link": "",
         "image_hash": "<IMAGE_HASH>",
         "attachment_style": "link",
     }' \
  -F 'contextual_multi_ads={
       "enroll_status": "OPT_IN"
  -F "access_token=<ACCESS_TOKEN>" \<AD_ACCOUNT_ID>/adcreatives

For more details, see Ad Creative.




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

Learn More