Partner-led Business Verification

Updated: May 21, 2026

This feature is currently only available to approved Select Solution and Premier Solution Partners. See our Sign up for partner-led business verification⁠ Help Center article to learn how to request approval.

This document describes how to create business verification submissions for clients who have been onboarded via Embedded Signup.

If you are an approved Solution Partner, you can gather required business verification documentation from your onboarded clients and submit their business for verification on their behalf. Decisions on submissions created in this way can be made in minutes instead of days.

Requirements

You must already be an approved Select Solution or Premier Solution Partner, and approved for access⁠
Your system user access token
The system user whose system token you are using must be an admin on your business portfolio (see our About business portfolio access⁠ Help Center article)
The system user whose system token you are using must have granted your app the business_management permission
The client's business portfolio ID (provided by the client⁠ or returned via API by requesting the owner_business_info field on the client's WABA ID, using their business token)

Limitations

You are limited to three submissions for a given client. If all three submissions are rejected, the client must complete business verification on their own. If your submission is rejected three times, share the following Help Center article with the client:

How to Verify Your Business on Meta⁠

Support

If you need help with partner-led business verification, open a Direct Support ticket:

Go to Direct Support⁠.
Click Ask a Question.
Under Topic select WABiz: Onboarding.
Click Request type and select Partner-led Business Verification for WhatsApp.

Supported documents

See the following Help Center article for a list of business documents that Meta accepts:

Upload official documents to verify your business⁠

Turnaround time

The average turnaround time for a submission is 5 minutes, but can take several hours. If you do not receive a webhook notifying of the outcome of a submission after 24 hours, please open a Direct Support ticket.

Webhooks

Submission decisions are communicated via account_update webhook, so make sure your app is subscribed to the account_update webhook field, and your app is subscribed to webhooks on the client's WhatsApp Business account.

Example webhook

{  
  "entry": [  
    {  
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",  
      "time": <WEBHOOK_SENT_TIMESTAMP>,  
      "changes": [  
        {  
          "value": {  
            "event": "PARTNER_CLIENT_CERTIFICATION_STATUS_UPDATE",  
            "partner_client_certification_info": {  
              "client_business_id": "<CUSTOMER_BUSINESS_PORTFOLIO_ID>",  
              "status": "<STATUS>",  
              "rejection_reasons": [  
                "<REJECTION_REASONS>"  
              ]  
  
            }  
          },  
          "field": "account_update"  
        }  
      ]  
    }  
  ],  
  "object": "whatsapp_business_account"  
}

Webhook parameters

Placeholder	Description	Example value
`<CUSTOMER_BUSINESS_PORTFOLIO_ID>`	Client's business portfolio ID.	`2729063490586005`
`<REJECTION_REASONS>`	Description of rejection reasons. Note that this parameter will be present even if the submission was rejected, but its value will be set to `NONE`. See the `rejection_reasons` field on the WhatsApp Business Partner Client Verification Submission node reference for a list of possible values and their descriptions.	`LEGAL_NAME_NOT_FOUND_IN_DOCUMENTS`
`<STATUS>`	Business verification status. Values can be: `APPROVED` — Indicates the client's business has been verified. `FAILED` — Indicates Meta is unable to verify the client's business based on the submitted business information.	`APPROVED`
`<WABA>`	Client's WABA ID.	`486585971195941`
`<WEBHOOK_SENT_TIMESTAMP>`	Unix timestamp indicating when the webhook was sent.	`1730752761`

Submitting a business for verification

Use the POST /<BUSINESS_PORTFOLIO_ID>/self_certify_whatsapp_business endpoint to initiate business verification for a client who has onboarded via your implementation of Embedded Signup.

Request

curl 'https://graph.facebook.com/v25.0<BUSINESS_PORTFOLIO_ID>/self_certify_whatsapp_business' \
-H 'Authorization: Bearer <SYSTEM_TOKEN>' \
-F 'end_business_id="<CUSTOMER_BUSINESS_PORTFOLIO_ID>"' \
-F 'business_documents[]=@"<DOCUMENT_PATH>"' \
-F 'business_documents[]=@"<DOCUMENT_PATH>"' \
-F 'business_documents[]=@"<DOCUMENT_PATH>"'

Request parameters

Placeholder	Description	Example value
`<BUSINESS_PORTFOLIO_ID>`	Required. Your business portfolio ID.	`506914307656634`
`<CUSTOMER_BUSINESS_PORTFOLIO_ID>`	Required. The client's business portfolio ID.	`2729063490586005`
`<DOCUMENT_PATH>`	Required. Path to the client's business document that you are submitting on their behalf. You can submit a maximum of 3 documents (the example request above submits 3). Use one parameter per document. The maximum size of each document is 5 MB. Supported file types: * PDF * JPEG * JPG * PNG See our Upload official documents to verify your business⁠ Help Center article for documents Meta accepts.	`NP7sEWs3x/wind_and_wool_bank_statement_04302024.txt`
`<SYSTEM_TOKEN>`	Required. Your system user access token.	`EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD`

Response

Upon success:

{  
  "success": true,  
  "message": "Your request has been received and will be reviewed shortly.",  
  "verification_attempts": <VERIFICATION_ATTEMPTS>  
}

Response parameters

Placeholder	Description	Example value
`<VERIFICATION_ATTEMPTS>`	Count of business verification submissions you have initiated on behalf of the client.	`1`

Getting submission status

Use the GET /<BUSINESS_PORTFOLIO_ID>/self_certified_whatsapp_business_submissions endpoint to get the verification status of submissions you have created for a single client, or for all of your clients.

Request

curl 'https://graph.facebook.com/v25.0<BUSINESS_PORTFOLIO_ID>/self_certified_whatsapp_business_submissions?fields=end_business_id=<CUSTOMER_BUSINESS_PORTFOLIO_ID>' \
-H 'Authorization: Bearer <SYSTEM_TOKEN>'

Request parameters

Placeholder	Description	Example value
`<CUSTOMER_BUSINESS_PORTFOLIO_ID>`	Optional. The client's business portfolio ID. Include this parameter if you only want to get data on submissions you have created for the business identified by the client's business portfolio ID.	`2729063490586005`
`<SYSTEM_TOKEN>`	Required. Your system user access token.	`EAAAN6tcBzAUBOZC82CW7iR2LiaZBwUHS4Y7FDtQxRUPy1PHZClDGZBZCgWdrTisgMjpFKiZAi1FBBQNO2IqZBAzdZAA16lmUs0XgRcCf6z1LLxQCgLXDEpg80d41UZBt1FKJZCqJFcTYXJvSMeHLvOdZwFyZBrV9ZPHZASSqxDZBUZASyFdzjiy2A1sippEsF4DVV5W2IlkOSr2LrMLuYoNMYBy8xQczzOKDOMccqHEZD`

Response

Upon success, the endpoint returns an array of WhatsApp Business Partner Client Verification Submission nodes, with default fields on each node.

{  
  "data": [  
  
    // Structure for pending or approved submissions  
    {  
      "verification_status": "<VERIFICATION_STATUS>",  
      "submitted_time": "<SUBMISSION_TIMESTAMP>",  
      "update_time": "<UPDATE_TIMESTAMP>",  
      "client_business_id": "<CUSTOMER_BUSINESS_PORTFOLIO_ID>",  
      "submitted_info": {  
        "business_vertical": "<CUSTOMER_BUSINESS_VERTICAL>"  
      },  
      "id": "<SUBMISSION_ID>"  
    },  
  
    // Structure for rejected submissions  
    {  
      "verification_status": "<VERIFICATION_STATUS>",  
      "rejection_reasons": [  
        "<REJECTION_REASON>",  
        "<REJECTION_REASON>"  
      ],  
      "submitted_time": "<SUBMISSION_TIMESTAMP>",  
      "update_time": "<UPDATE_TIMESTAMP>",  
      "client_business_id": "<CUSTOMER_BUSINESS_PORTFOLIO_ID>",  
      "submitted_info": {},  
      "id": "<SUBMISSION_ID>"  
    },  
  
    // Additional objects describing each submission would follow  
  
  ],  
  "paging": {  
    "cursors": {  
      "before": "<BEFORE_CURSOR>",  
      "after": "<AFTER_CURSOR>"  
    },  
    "next": "<URL_TO_FETCH_NEXT_RESULT_SET>"  
  }  
}

Response parameters

See the WhatsApp Business Partner Client Verification Submission node reference for descriptions of returned fields and parameter values.

Get business verification status

You can use the GET /<BUSINESS_PORTFOLIO_ID> endpoint and request the verification_status field on the client's business portfolio ID to see its verification status (alternatively, you can request the business_verification_status field on the client's WABA ID using their business token).

Request

curl 'https://graph.facebook.com/v25.0<BUSINESS_PORTFOLIO_ID>?fields=verification_status' \
-H 'Authorization: Bearer <BUSINESS_TOKEN>'

Request parameters

Placeholder	Description	Example value
`<BUSINESS_PORTFOLIO_ID>`	Required. The client's business portfolio ID.	`2729063490586005`
`<BUSINESS_TOKEN>`	Required. The client's business token.	`EAAAN6tcBzAUBOwtDtTfmZCJ9n3FHpSDcDTH86ekf89XnnMZAtaitMUysPDE7LES3CXkA4MmbKCghdQeU1boHr0QZA05SShiILcoUy7ZAb2GE7hrUEpYHKLDuP2sYZCURkZCHGEvEGjScGLHzC4KDm8tq2slt4BsOQE1HHX8DzHahdT51MRDqBw0YaeZByrVFZkVAoVTxXUtuKgDDdrmJQXMnI4jqJYetsZCP1efj5ygGscZBm4OvvuCYB039ZAFlyNn`

Response

{  
  "verification_status": "<VERIFICATION_STATUS>",  
  "id": "<BUSINESS_PORTFOLIO_ID>"  
}

Response parameters

Placeholder	Description	Example value
`<BUSINESS_PORTFOLIO_ID>`	The client's business portfolio ID.	`2729063490586005`
`<VERIFICATION_STATUS>`	The business portfolio's verification status. See the `verification_status` field on the Business node reference for a list of possible values.	`verified`

Upi Intent

message_template_status_update webhook reference

Partner-led Business Verification ​

Requirements ​

Limitations ​

Support ​

Supported documents ​

Turnaround time ​

Webhooks ​

Example webhook ​

Webhook parameters ​

Submitting a business for verification ​

Request ​

Request parameters ​

Response ​

Response parameters ​

Getting submission status ​

Request ​

Request parameters ​

Response ​

Response parameters ​

Get business verification status ​

Request ​

Request parameters ​

Response ​

Response parameters ​

Partner-led Business Verification

Requirements

Limitations

Support

Supported documents

Turnaround time

Webhooks

Example webhook

Webhook parameters

Submitting a business for verification

Request

Request parameters

Response

Response parameters

Getting submission status

Request

Request parameters

Response

Response parameters

Get business verification status

Request

Request parameters

Response

Response parameters