---
title: "Send WhatsApp Audio"
method: POST
path: "/message/sendWhatsAppAudio/{instance}"
tags: ["Message Controller"]
---

# Send WhatsApp Audio

`POST /message/sendWhatsAppAudio/{instance}`

## Request

- Base URL: `https://evolution-example`
- URL: `https://evolution-example/message/sendWhatsAppAudio/{instance}`
- Auth: API key in header `apikey`

Send WhatsApp Audio

## Path parameters

- `instance` string, required

## Request body

- object
  - `number` string, required: Number to receive the message (with country code)
  - `audio` string, required: url or base64
  - `delay` integer: Presence time in milliseconds before sending message
  - `linkPreview` boolean: Shows a preview of the target website if there's a link within the message
  - `mentionsEveryOne` boolean: Mentioned everyone when the message send
  - `mentioned` string[]: Numbers to mention
  - `quoted` object
    - `key` object
      - `id` string: Quoted message ID
    - `message` object
      - `conversation` string: Quoted message content

## Response `200`

Ok

- object
  - `key` object: The key of the message, which identifies the message in the chat.
    - `remoteJid` string: The remote Jid.
    - `fromMe` boolean: Indicates whether the message was sent by the user.
    - `id` string: The ID of the message.
  - `message` object: The message content, which may include various types of messages like text, images, audio, etc.
    - `audioMessage` object: Details of the audio message.
      - `url` string: The URL of the audio message.
      - `mimetype` string: The MIME type of the audio message.
      - `fileSha256` string: The SHA-256 hash of the audio file.
      - `fileLength` string: The length of the audio file.
      - `seconds` integer: The duration of the audio message in seconds.
      - `ptt` boolean: Indicates whether the audio message is a push-to-talk (PTT) message.
      - `mediaKey` string: The media key of the audio message.
      - `fileEncSha256` string: The SHA-256 hash of the encrypted audio file.
      - `directPath` string: The direct path to the audio file.
      - `mediaKeyTimestamp` string: The timestamp of the media key.
  - `messageTimestamp` string: The timestamp of the message, represented as a string.
  - `status` string: The status of the message, such as sent, received, or pending.

## Changes

- **2024-11-25** (v2) `f4f5817334cd`: 1 warning, 5 info
  - removed the request property `options`
  - added the new optional request property `delay`
  - added the new optional request property `linkPreview`
  - added the new optional request property `mentioned`
  - …2 more
- **2024-11-25** (v2) `89c1fb90d3da`: 1 breaking, 3 warning, 4 info
  - added the new required request property `audio`
  - removed the request property `audioMessage`
  - removed the request property `options/encoding`
  - removed the request property `options/presence`
  - …4 more
- **2024-11-25** (v2) `c153448703e5`: 2 breaking, 5 info
  - added the new required request property `audioMessage`
  - added the new required request property `number`
  - api operation id `sendWhatsAppAudio` was added
  - the endpoint scheme security `ApiKeyAuth` was added to the API
  - …3 more
- **2024-09-09** (v2) `0c4620ca5ed5`: 7 warning, 4 info
  - removed the request property `audio`
  - removed the request property `delay`
  - removed the request property `encoding`
  - removed the request property `mentioned`
  - …7 more
- **2024-08-09** (v2) `996acfdb07ce`: 1 breaking, 2 warning, 5 info
  - added the new required request property `audio`
  - removed the request property `audioMessage`
  - removed the request property `options`
  - added the new optional request property `delay`
  - …4 more

[Operation history](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/changes/message/sendWhatsAppAudio/:instance/post.md)

---

[API](https://skmtc.dev/evolution-foundation/apis/evolution-api-3.md) - [All operations](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/llms.txt) - [OpenAPI document](https://skmtc.dev/evolution-foundation/apis/evolution-api-3/revisions/153363ee7f38?raw)