Appeals APIs

There are multiple reasons why many ad accounts and Business Managers may be banned, such as risk, compliance, quality, and other reasons.

Following are the API integrations needed to appeal banned ad accounts and Business Managers.

App Permissions

Apps should have the following permissions:

business_management

IDs

PARENT_BUSINESS_MANAGER_ID: ID of the Meta Business Manager of the partner who owns the app.
AD_ACCOUNT_IDS: IDs of the child ad accounts that the parent Business Manager appeals for the clients.
BUSINESS_MANAGER_IDS: ID of the child Business Managers that the parent Business Manager appeals for the clients.

Access Tokens

User_Personal_Access_Token:
- This token is generated using Facebook Login.
- The partner should request global business_management scopes on the user's businesses rather than granular scopes.
- This person should have admin privileges on the asset being shared
Parent_BM_Admin_System_User_Access_Token:
- The token of the admin system user in the parent Business Manager.

Appeal Statuses

The appeals being created can have these statuses:

appeal_entity_invalid - The entity (ad_account_id/business_manager_id) is not eligible to be appealed for multiple reasons.
appeal_creation_failure - Creation of appeal failed because it was not allowed in the pipeline for the appeals process, even though the entity can be appealed.
appeal_creation_success - Creation of appeal was successful and a notification will be sent once the appeal has been judged by our team.

Appeal Banned Ad Account IDs

You can appeal the child ad account IDs using the User_Personal_Access_Token or Parent_BM_Admin_System_User_Access_Token:

POST <parent_business_manager_id>/ad_review_requests

Options and parameters for this request include:

Level	Description
`ad_account_ids` Type: list:numeric	Required. The list of child ad account IDs to be appealed.
`app` Type: numeric	Required. The partner app ID.

If the entities are successfully appealed, the following response is returned with appeal_case_id created:

{
  "response": [
    {
      "entity_id": "<appealed_entity_id>",
      "appeal_case_id": "<appeal_created_case_id>",
      "status": "appeal_creation_success",
      "reason": "Appeal created successfully"
    }
  ]
}

If the appeal request is rejected, the API request returns the following response with status either as appeal_entity_invalid or appeal_creation_failure for each entity appealed:

{
  "response": [
    {
      "entity_id": "<appealed_entity_id>",
      "status": "appeal_entity_invalid",
      "reason": "Entity invalid"
    },
    {
      "entity_id": "<appealed_entity_id>",
      "status": "appeal_creation_failure",
      "reason": "Appeal creation failed"
    }
  ]
}

Note that a maximum of 50 ad accounts can be appealed at a time.

Appeal Banned Business Manager IDs

You can appeal the child Business Manager IDs using the User_Personal_Access_Token or Parent_BM_Admin_System_User_Access_Token:

POST <parent_business_manager_id>/bm_review_requests