---
title: "Request Verification Code for Pre-Verified Phone Number"
method: POST
path: "/{Version}/{Pre-Verified-Phone-Number-ID}/request_code"
tags: ["Pre-Verified Phone Numbers"]
---

# Request Verification Code for Pre-Verified Phone Number

`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

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

## Path parameters

- `Version` string, required
- `Pre-Verified-Phone-Number-ID` string, required

## Headers

- `User-Agent` string
- `Authorization` string, required

## Request body

- RequestCodeRequest: Request body for requesting a verification code
  - `code_method` 'SMS' | 'VOICE', required: Method for receiving the verification code
  - `language` string, required: Language locale for the verification message

## Response `200`

Successfully requested verification code

- RequestCodeResponse: Response after successfully requesting a verification code
  - `success` boolean, required: Indicates whether the verification code request was successful

## Other responses

- `400`: Bad Request - Invalid parameters or malformed request
- `401`: Unauthorized - Invalid or missing access token
- `403`: Forbidden - Insufficient permissions or access denied
- `404`: Not Found - Pre-verified phone number ID does not exist or is not accessible
- `422`: Unprocessable Entity - Request parameters are valid but cannot be processed
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error - Unexpected server error

---

[API](https://skmtc.dev/meta/apis/whatsapp-business-messaging.md) - [All operations](https://skmtc.dev/meta/apis/whatsapp-business-messaging/llms.txt) - [OpenAPI document](https://skmtc.dev/meta/apis/whatsapp-business-messaging/revisions/5c1973265369?raw)