Delete a Seller

This page has guidance on how to delete a seller from managed partner ads.

Note: Businesses that sell their products through marketplaces or retailers are referred to as sellers. Once you onboard a seller into managed partner ads, they are considered a managed partner. For simplicity, this page will use "seller" to also refer to managed partners (i.e., onboarded sellers).

The Seller Deletion API disables the ad account and deletes any assets that were created during onboarding, including:

• Catalog segment
• Page
• System user
• Business

Before You Begin

Before you delete 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
4. Onboard a Seller
5. Generate appsecret_proof

Required Permissions

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

• Business Admin
• Manage Credit
• App Developer

Seller Deletion API Call

Request

curl \
  -F 'access_token=<ACCESS_TOKEN>' \
  -F 'asyncbatch=[ 
      { 
        "method": "DELETE", 
        "relative_url": "<MARKETPLACE_BM_ID>/managed_partner_businesses?child_business_external_id=<VENDOR_ID>", 
        "name": "<ASYNC_SESSION_NAME>"
      } 
  ]' \
  -F "appsecret_proof=<APP_SECRET>" \
  "https://graph.facebook.com/v19.0"

The response to the API call is returned immediately with an ASYNC_SESSION_ID. While the request continues to be processed, the ASYNC_SESSION_ID should be polled until a terminal state [COMPLETED|FAILED] is reached.

Parameters

Response

{
  "async_sessions": [
    {
      "id": "<ASYNC_SESSION_ID>",
      "name": "<ASYNC_SESSION_NAME>"
    }
  ]
}

Use the ASYNC_SESSION_ID to get the deletion status of the seller from managed partner ads.

See How to Poll Async Session for Response for more information.

Success Response

If the status is COMPLETED, the resulting data of polling async session will look like:

{
  "result": "{\"id\":\"<MANAGED_PARTNER_BM_ID>\", \"success\":true}",
  "status": "COMPLETED",
  "id": "<ASYNC_SESSION_ID>"
}

Failed Response

If the status is FAILED, the resulting data of polling async session will look like:

Show Failure Response

Error Codes

Requests made to seller deletion API can result in several different error responses. See How to handle an error for more information.

See More

• Check Seller Eligibility
• Onboard a Seller
• How to Poll Async Session for Response
• Error Handling Guide