Verify OTP Code for Pre-Verified Phone Number
Verify the OTP code received for a pre-verified phone number to complete the verification process. This endpoint validates the code and updates the verification status of the phone number.
Use Cases:
- Complete phone number verification during WhatsApp Business onboarding
- Verify ownership of phone numbers for business messaging
- Enable phone numbers for WhatsApp Business API usage
Rate Limiting: This endpoint has specific rate limits to prevent abuse:
- 125 requests per hour for business use cases
- Standard Graph API rate limits also apply
Code Validation:
- Codes are time-sensitive and expire after a set period
- Each code can only be used once
- Invalid or expired codes will result in verification failure
Error Handling:
- Invalid codes return 400 Bad Request
- Expired codes return 422 Unprocessable Entity
- Rate limit exceeded returns 429 Too Many Requests
Request
- Base URLhttps://graph.facebook.com
- URLhttps://graph.facebook.com/{Version}/{Pre-Verified-Phone-Number-ID}/verify_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 you create the pre-verified phone number and can be found in your WhatsApp Business Manager or through phone number APIs.
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": "123456"
}Response
Successfully verified the OTP code
Example response
{
"success": true,
"id": "1234567890123456"
}Changes
No recorded changes to this operation across all 5 revisions of this API.