> For the complete documentation index, see [llms.txt](https://developer.9bits.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.9bits.net/voice/voice-messaging-api/send-a-voice-message.md).

# Send a voice message

This method lets you deliver a voice message to a PSTN number, and deliver voice message to multiple PSTN numbers.

### Arguments

> <mark style="color:green;">to</mark>   The destination to be called. The destination should be a regular number. A regular number should be specified with the country code followed by the number.
>
> Example 2348020000000
>
> You can deliver voice message to multiple numbers at once by adding all the numbers in a square bracket. For example, if you want to deliver to two numbers, specify them in the <mark style="color:red;">to</mark> field:
>
> \["2348020000000", "2348030000000"]
>
> Note: The maximum number of unique destinations accepted in the "to" field is 1000.
>
> <mark style="color:green;">media\_url</mark>   The location of the media/audio file. This specifies where the media file is located.&#x20;
>
> Example  <https://www.learningcontainer.com/wp-content/uploads/2020/02/Kalimba.mp3>
>
> The media file will be fetched and then converted to the most suitable format for the best audio quality over the GSM network.

Example POST request

```json
{
    "to": ["2348020000000", "2348030000000"],
    "media_url": "https://www.learningcontainer.com/wp-content/uploads/2020/02/Kalimba.mp3"
}
```

Specifying <mark style="color:orange;">from</mark> is not necessary as your registered caller id will be fetched and used. If there are multiple caller ids, then only one will be randomly selected.

### Callbacks

For every attempt to deliver a voice message, 9bits sends a status update to your URL configured as a callback.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developer.9bits.net/voice/voice-messaging-api/send-a-voice-message.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.