Send a voice note to a group chat

POST

/sendGroupVoiceNote

POST

/sendGroupVoiceNote

$ curl -X POST https://api.messageblue.ai/sendGroupVoiceNote \
>      -H "X-App-Id: <apiKey>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "groupId": "iMessage;+;chat789",
>   "voiceNote": {
>     "url": "https://storage.messageblue.ai/voice-notes/meeting-2024-06-01.m4a"
>   }
> }'

1 {
2   "ok": true,
3   "data": {
4     "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
5     "status": "sent",
6     "type": "result",
7     "from": "+14155550123",
8     "to": "iMessage;+;chat789",
9     "groupId": "iMessage;+;chat789",
10     "text": "",
11     "attachments": [
12       "https://storage.messageblue.ai/voice-notes/meeting-2024-06-01.m4a"
13     ],
14     "messageGuid": "A1B2C3D4E5F6G7H8I9J0",
15     "chatGuid": "chat789",
16     "outbound": true,
17     "iMessageNumber": "+14155550123",
18     "idempotencyKey": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
19   },
20   "meta": {
21     "requestId": "550e8400-e29b-41d4-a716-446655440000",
22     "timestamp": "2026-07-10T06:00:00.000Z"
23   }
24 }

Accepts a voiceNote URL and forwards it as an attachment to /sendGroupMessage.

Authentication

X-App-Idstring

Your MessageBlue App ID, sent in clear on every request. It is paired with request signing: each request is also signed with your App Secret (see the Authentication tag). The App Secret itself is NEVER transmitted — it is only the HMAC signing key.

Request

This endpoint expects an object.

groupIdstringRequired

voiceNoteobjectRequired

fromstringOptional

textstringOptional

status_callbackstringOptionalformat: "uri"

Response

Voice note dispatched

okboolean

dataobject

Endpoint-specific payload wrapped in a standard success envelope.

metaobject

Errors

400

Bad Request Error

Authentication

Headers

Request

Response

Errors