Registering business phone numbers | Developer Documentation

This document describes the steps to programmatically register business phone numbers on WhatsApp Business Accounts (WABA).

Note that Embedded Signup performs steps 1-3 automatically (unless you are bypassing the phone number addition screen) so you only need to perform step 4 when a business customer completes the flow. If you have disabled phone number selection, however, you must perform all 4 steps.

Registering business phone numbers is a four step process:

These steps are described below.

You can also perform all 4 steps repeatedly to register business phone numbers in bulk.

Business phone numbers must meet our phone number requirements.

Send a POST request to the WhatsApp Business Phone Number > Request Code endpoint to have a verification code sent to the business phone number.

Placeholder	Description	Example Value
<CODE_METHOD>	Required. Indicates how you want the verification code delivered to the business phone number. Values can be SMS or VOICE.	SMS
<LANGUAGE>	Required. Indicates language used in delivered verification code.	en_US

{
  "success": <SUCCESS>
}

Placeholder	Description	Example Value
<SUCCESS>	Boolean indicating success or failure. Upon success, the API will respond with true and a verification code will be sent to the business phone number using the method specified in your request.	true

Example of an SMS message in English containing a verification code, delivered to a business phone number:

Send a POST request to the WhatsApp Business Phone Number > Verify Code endpoint to verify the business phone number, using the verification code contained in the SMS or voice message delivered to the number.

Placeholder	Description	Example Value
<CODE> String	Required. Verification code, without the hyphen.	123830

{
  "success": <SUCCESS>
}

Placeholder	Description	Example Value
<SUCCESS>	Boolean indicating success or failure. Upon success, the API will respond with true, indicating that the business phone number has been verified.	true