Skip to main content
POST
Send Audio

Basic Usage


Request Body

Supported formats: MP3, AAC, OGG. Audio messages do not support captions.

Response

Success (200)

Error: Missing Required Field (400)


Integration Example


Media URLs

Ensure the audio URL is publicly accessible. The API needs to download the file before uploading to Meta.

Authorizations

Authorization
string
header
required

Bearer token for authentication. Format: Bearer YOUR_BEARER_TOKEN

Body

application/json
phone_number
string
required

Recipient phone number with country code

Example:

"+27123456789"

message_type
enum<string>
required

Must be "audio"

Available options:
audio
Example:

"audio"

media_url
string
required

Publicly accessible URL to the audio file

Example:

"https://example.com/message.mp3"

context_message_id
string

WhatsApp message ID to reply to

Example:

"wamid.HBgLMjc4MTIzNDU2NzgVAgASGBQzRUI..."

Response

Message sent successfully

success
boolean
Example:

true

message
string
Example:

"Message sent successfully"

data
object