Managed Partner Ads

Check Seller Eligibility

This page gives guidance on which sellers to onboard into managed partner ads, as well as how to check eligibility. You may begin onboarding any eligible seller, but consider prioritizing sellers with a higher average purchase value, such sellers tend to have better return on ad spend.

Before You Begin

Before you check the eligibility of a seller, make sure you have completed these steps:

  1. Create an Admin System User
  2. Assign Permissions to the Admin System User
  3. Generate an Access Token for the Admin System User

Seller Eligibility Criteria

A seller is considered eligible based on the following criteria:

  • Average purchase value in the past 28 days
  • Number of purchases in the past 28 days

Note: Sellers with an higher average purchase value tend to have better return on ad spend and may be a better partner to onboard. You can download a list of your eligible and recommended sellers from the Discover page in Collaboration Center.

Required Permissions

To call the Seller Eligibility API, you will need the following permissions:

  • Business Admin
  • Catalog Admin
  • Manage Credit
  • App Developer

Seller Eligibility API Call

Request

curl -X GET \
 "https://graph.facebook.com/v<API_VERSION>/<Business_ID>?fields=collaborative_ads_managed_partner_eligibility.vendor_id(<INSERT_VENDOR_ID>).catalog_id(<INSERT_CATALOG_ID>)&access_token=<ACCESS_TOKEN>"

Parameters

NameDescription

catalog_id

numeric string

Required.
The ID of the marketplace's catalog, referred to as a parent catalog.
During onboarding, this catalog may be filtered using vendor_id=<child_business_external_id> to create a catalog segment for a seller.

marketplace_bm_id

string

Required.
The marketplace's Business Manager ID. See Find your Business ID in Meta Business Manager for more information.

vendor_id

string

Required.
The unique ID of the seller for a marketplace.

Response

{
  "is_eligible": bool,
  "reason_code": "enum string",
  "reason_description": "enum string",
}

Parameters

NameDescription

is_eligible

bool

Indicates whether the seller is eligible.

reason_code

enum string

The reason code about the seller eligibility.
Empty if the seller is eligible.

reason_description

enum string

The reason description about the seller eligibility.
Empty if seller is eligible.

Error Codes

Error CodeError SubcodeDescription

1800000

2310114

Complete the managed partner ads onboarding process in Collaboration Center.

1800012

2310173

Check the marketplace you entered ({marketplace_id}). If it's the correct ID, ask someone with full control to go to Business settings in Business Manager to give you admin access. Once assigned, retry the request.

1800101

2310116

Your business {business_id} does not manage the catalog ID you entered {catalog_id}. Enter a catalog ID that your business manages.

See More