Request Verification Code for Pre-Verified Phone Number
Request a verification code for a pre-verified phone number via SMS or voice call. This is part of the WhatsApp Business Account onboarding process where pre-approved phone numbers must be verified before they can be used for messaging.
Process Flow:
- Call this endpoint to request a verification code
- User receives code via SMS or voice call
- Use the verify_code endpoint to complete verification
- Phone number becomes active for messaging
Rate Limiting:
- Limited number of code requests per phone number per time period
- Exponential backoff recommended for retry attempts
- Voice calls may have additional restrictions
Language Support: Verification messages are sent in the specified language when available. Falls back to English (en_US) if the requested language is not supported.
Security Considerations:
- Codes expire after a short time period
- Limited number of verification attempts allowed
- Phone number must be pre-verified and owned by requesting business
Request
- Base URLhttps://graph.facebook.com
- URLhttps://graph.facebook.com/{Version}/{Pre-Verified-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 pre-verified phone number ID. This ID is provided when the phone number is pre-verified and can be found in your WhatsApp Business Account settings.
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.
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.