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

# Request Phone Number Verification Code

`POST /{Version}/{Phone-Number-ID}/request_code`

## Request

- Base URL: `https://graph.facebook.com`
- URL: `https://graph.facebook.com/{Version}/{Phone-Number-ID}/request_code`
- Auth: HTTP bearer

Request a verification code for a WhatsApp Business phone number via SMS or voice call.
This is the first step in the phone number verification process.


**Use Cases:**
- Initial verification of newly added phone numbers
- Re-verification when phone number status requires it
- Switching between SMS and voice verification methods

**Rate Limiting:**
Standard Graph API rate limits apply. Additional rate limiting may be enforced
for verification code requests to prevent abuse.

**Security:**
Verification codes are sent only to the registered phone number and expire
after a short time period. Multiple failed attempts may result in temporary blocking.

## Path parameters

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

## Headers

- `User-Agent` string
- `Authorization` string, required
- `Content-Type` 'application/json' | 'application/x-www-form-urlencoded' | 'multipart/form-data', 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 - 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)