Send an audio message

Sends an audio file. Needs an open 24-hour window. Give the file as a public link or as an id from POST /v1/media/upload.

Example

curl -X POST "$HELLO_API_URL/v1/<your-phone-number-id>/messages" \
  -H "Authorization: Bearer $HELLO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": "+919999999999",
    "type": "audio",
    "audio": {
      "link": "https://example.com/audio/appointment-reminder.mp3"
    }
  }'

By media ID:

{
  "to": "+919999999999",
  "type": "audio",
  "audio": { "id": "1099999999999012" }
}

Response

202 Accepted (queued), or 200 with ?sync=true once WhatsApp accepts it. See Send a message.

Fields

Field	Type	Required	Description
`audio.link`	string	One of `link` / `id`	Public HTTPS URL of the audio file
`audio.id`	string	One of `link` / `id`	`media_id` from `/v1/media/upload`. Takes precedence if both are set.

WhatsApp doesn’t allow captions on audio, so a caption field is ignored.

Supported formats: audio/aac, audio/amr, audio/mpeg (MP3), audio/mp4 and audio/ogg (Opus codec only), up to 16 MB. An OGG/Opus file is shown as a voice note.

Common errors

Status	`code`	Cause
`403`	`OUTSIDE_24H_WINDOW`	The recipient’s 24-hour window is closed
`400`	`VALIDATION_ERROR`	`audio` is missing or the wrong shape
`422`	`SEND_FAILED`	(`?sync=true` only) WhatsApp rejected the send