Send Audio

POST

/v1/whatsapp/service-account/sendAudio

Sends a WhatsApp audio/voice-note message from a workspace channel to a destination number.

Auth: OAuth2 client-credentials via /connect/token (policy VoxaAPIScope), same as all service-account endpoints.

Accepted audio formats:

Native (sent as-is): audio/aac, audio/amr, audio/mpeg (.mp3), audio/mp4 (.m4a), audio/ogg

Auto-converted before delivery: audio/wav, audio/x-wav, audio/webm

Size limit: 16 MB (Meta's WhatsApp audio limit).

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200OK

application/json

The audio message has been accepted and queued for delivery.

Bodyapplication/json

🟢200OK

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Record Not Found

🟠408

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.voxa.sa/v1/whatsapp/service-account/sendAudio' \
--header 'Authorization: Bearer eyJh......' \
--header 'content-type: application/json' \
--data '{
    "channelId": "3a197.........",
    "audioUrl": "https://example.com/audio.mp3",
    "toNumber": "9665xxxxxxxx"
}'

Response Example

200 - Official/Dialog360 channel

{
    "contactId": "3a1ca9.........",
    "status": "Sent",
    "message": "Message sent",
    "conversationEventId": "3a1ca9.........",
    "messageId": null
}

Modified at 2026-07-06 16:14:08

Send Image

Send Video