> For the complete documentation index, see [llms.txt](https://docs.taqnyat.sa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.taqnyat.sa/api-reference/api-integration-guide/phone-number-format.md).

# Phone Number Format

Recipient phone numbers must be provided in **international format**.

Do not include:

* `+`
* `00`
* Spaces
* Dashes
* Parentheses

### Correct Format

Example for a Saudi mobile number:

```
9665XXXXXXXX
```

Example for a Jordanian mobile number:

```
9627XXXXXXXX
```

### Incorrect Examples

```
+9665XXXXXXXX
009665XXXXXXXX
966 5XXXXXXXX
966-5XXXXXXXX
```

### Using the Number in a Request

When sending a WhatsApp message, the recipient number is included in the request payload.

Example:

```
{
  "to": "9665XXXXXXXX"
}
```

The exact request structure may vary depending on the endpoint being used, but the recipient number should always follow the required international format.

### Important Notes

* Make sure the country code is included.
* Remove the local leading zero before adding the country code.
* Verify that the number is registered on WhatsApp before sending when applicable.
* Keep phone-number formatting consistent when preparing bulk campaign files or API requests.

> Incorrectly formatted numbers may cause message delivery to fail.