Request Phone Number Verification Code
Request a verification code for a WhatsApp Business phone number via SMS or voice call. This is the first step in the phone number verification process.
Use Cases:
- Initial verification of newly added phone numbers
- Re-verification when phone number status requires it
- Switching between SMS and voice verification methods
Rate Limiting: Standard Graph API rate limits apply. Additional rate limiting may be enforced for verification code requests to prevent abuse.
Security: Verification codes are sent only to the registered phone number and expire after a short time period. Multiple failed attempts may result in temporary blocking.
Request
- Base URLhttps://graph.facebook.com
- URLhttps://graph.facebook.com/{Version}/{Phone-Number-ID}/request_code
- AuthHTTP bearer
Path parameters
Graph API version to use for this request. Determines the API behavior and available features.
Your WhatsApp Business phone number ID. This ID represents the phone number status entity (EntWhatsAppBusinessAccountToNumberCurrentStatus) and can be obtained from your WhatsApp Business Account phone numbers list.
Headers
The user agent string identifying the client software making the request.
Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.
Media type of the request body
Request body
Example request
{
"code_method": "SMS",
"language": "en_US"
}Response
Successfully requested verification code
Example response
{
"success": true
}Changes
No recorded changes to this operation across all 5 revisions of this API.