Skip to main content
POST
Send a voice memo to a chat

Authorizations

Authorization
string
header
required

Bearer token authentication. Include your API token in the Authorization header.

Format: Authorization: Bearer <your-token>

Path Parameters

chatId
string<uuid>
required

Unique identifier of the chat

Body

application/json

Request to send a voice memo to a chat (chat_id provided in path). Exactly one of voice_memo_url or attachment_id must be provided.

voice_memo_url
string<uri>
required

URL of the voice memo audio file. Must be a publicly accessible HTTPS URL.

Either voice_memo_url or attachment_id must be provided, but not both.

attachment_id
string<uuid>

Reference to a voice memo file pre-uploaded via POST /v1/attachments. The file is already stored, so sends using this ID skip the download step.

Either voice_memo_url or attachment_id must be provided, but not both.

Response

Voice memo accepted for delivery

Response for sending a voice memo to a chat

voice_memo
object
required