Pre-Verified Phone Numbers

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:

  1. Call this endpoint to request a verification code
  2. User receives code via SMS or voice call
  3. Use the verify_code endpoint to complete verification
  4. 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
post/{Version}/{Pre-Verified-Phone-Number-ID}/request_code

Request

  • Base URL
    https://graph.facebook.com
  • URL
    https://graph.facebook.com/{Version}/{Pre-Verified-Phone-Number-ID}/request_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 the phone number is pre-verified and can be found in your WhatsApp Business Account settings.

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

code_method'SMS' | 'VOICE' required

Method for receiving the verification code

languagestring required

Language locale for the verification message

Example request

{
  "code_method": "SMS",
  "language": "en_US"
}

Response

Successfully requested verification code

successboolean required

Indicates whether the verification code request was successful

Example response

{
  "success": true
}

Changes

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