---
title: "Send audio message"
method: POST
path: "/v2/messages/audio"
tags: ["Messages"]
---

# Send audio message

`POST /v2/messages/audio`

Send an audio message via WhatsApp Official. The audio URL is sent directly to the Meta API. No caption support for audio messages. Set "voice" to true to deliver the file as a WhatsApp voice note (PTT) instead of a regular audio attachment; for PTT the file must be .ogg encoded with the OPUS codec (Meta validates and rejects other formats). Returns immediately with QUEUED status.

## Headers

- `api-token` string, required

## Request body

- object
  - `channel_account_id` string, uuid, required — UUID of the WhatsApp Official channel account
  - `contact_id` string, uuid, required — UUID of the contact to send the audio to
  - `url` string, uri, required — Direct URL of the audio file to send
  - `voice` boolean — Optional. When true, the audio is delivered as a WhatsApp voice note (PTT) instead of a regular audio attachment. Requires an .ogg file encoded with the OPUS codec.
  - `chat_id` string, uuid — Optional UUID of an existing chat. If not provided, the system will find or create a chat automatically.

## Response `200`

Audio message queued for sending

- object
  - `status` integer
  - `data` object
    - `success` boolean
    - `message_id` string, uuid
    - `chat_id` string, uuid
    - `status` 'QUEUED'

## Other responses

- `400` — Validation error
- `401` — Authentication error - invalid or missing api-token
- `404` — Resource not found

---

[API](https://skmtc.net/clint/apis/clint-api.md) · [All operations](https://skmtc.net/clint/apis/clint-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/clint/clint-api/revisions/12b8f9eff943/schema)