Verify Phone Number Verification Code
Verify a phone number verification code for a WhatsApp Business Account phone number. This endpoint is used to complete the phone number verification process by submitting the verification code received via SMS or voice call.
Use Cases:
- Complete phone number verification during initial setup
- Verify phone number ownership for messaging capabilities
- Finalize phone number registration process
- Complete phone number migration verification
Rate Limiting: Verification attempts are rate-limited to prevent abuse. Failed attempts may result in temporary blocking. Use appropriate retry logic with exponential backoff.
Security: Verification codes are time-limited (typically 10 minutes) and single-use. Multiple failed attempts may trigger additional security measures.
Request
- Base URLhttps://graph.facebook.com
- URLhttps://graph.facebook.com/{Version}/{Phone-Number-ID}/verify_code
- AuthHTTP bearer
Path parameters
Graph API version to use for this request. Determines the API behavior and available features.
The WhatsApp Business Account phone number ID that needs verification. This ID is provided when you add a phone number to your WhatsApp Business Account.
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": "123456"
}Response
Successfully verified the phone number verification code
Example response
{
"success": true,
"id": "1234567890123456"
}Changes
No recorded changes to this operation across all 5 revisions of this API.