Skip to main content

Partner-led Business Verification | Developer Documentation

Partner-led Business Verification

Updated: Nov 14, 2025
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 business customers who have been onboarded via Embedded Signup.
If you are an approved Solution Partner, you can gather required business verification documentation from your onboarded business customers and submit their business for verification on their behalf. Decisions on submissions created in this way can be made in minutes instead days.

Requirements

you must already be an approved Select Solution or Premier Solution Partner, and approved for access?your system user access tokenthe 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 permissionthe business customer's business portfolio ID (provided by the customer? or returned via API by requesting the owner_business_info field on the customer's WABA ID, using their business token)

Limitations

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

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 we will accept:

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 business customer's WhatsApp Business Account.

Webhook parameters

Placeholder Description Example value
<CUSTOMER_BUSINESS_PORTFOLIO_ID>
Business customer'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 customer's business has been verified.
FAILED - Indicates we were unable to verify the customer's business based on the submitted business information.
APPROVED
<WABA>
Business customer's WABA ID.
486585971195941
<WEBHOOK_SENT_TIMESTAMP>
Unix timestamp indicating when the webhook was sent.
1730752761

Getting submission status

Request parameters

Placeholder Description Example value
<CUSTOMER_BUSINESS_PORTFOLIO_ID>
Optional.
The customer'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 customer'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.

Response parameters

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

Get business verification status

Request parameters

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

Response parameters

Placeholder Description Example value
<BUSINESS_PORTFOLIO_ID>
The business customer'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

No comments to display

Back to top