Phone Number Verification

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.

post/{Version}/{Phone-Number-ID}/verify_code

Request

  • Base URL
    https://graph.facebook.com
  • URL
    https://graph.facebook.com/{Version}/{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.

Phone-Number-IDstring required

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

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.

Content-Type'application/json' | 'application/x-www-form-urlencoded' | 'multipart/form-data' required
Example:application/json

Media type of the request body

Request body

codestring required

6-digit verification code received via SMS or voice

Example request

{
  "code": "123456"
}

Response

Successfully verified the phone number verification 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.