Pre-Verified Phone Numbers

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
post/{Version}/{Pre-Verified-Phone-Number-ID}/verify_code

Request

  • Base URL
    https://graph.facebook.com
  • URL
    https://graph.facebook.com/{Version}/{Pre-Verified-Phone-Number-ID}/verify_code
  • Auth
    HTTP bearer

Path parameters

Versionstring required

Graph API version to use for this request. Determines the API behavior and available features.

Pre-Verified-Phone-Number-IDstring required

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

User-Agentstring
Example:Meta-Business-Messaging-OpenAPI/1.0.0;spec=2025-10-21

The user agent string identifying the client software making the request.

Authorizationstring required
Example:Bearer EAABwzLixnjYBOzYmNMJJGfHq9DgNh...

Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.

Request body

codestring required

6-digit verification code received via SMS or voice

Example request

{
  "code": "123456"
}

Response

Successfully verified the OTP code

successboolean required

Indicates whether the verification code was successfully verified

idstring

The phone number ID that was verified

Example response

{
  "success": true,
  "id": "1234567890123456"
}

Changes

No recorded changes to this operation across all 5 revisions of this API.