Voice Memos

​

Send a voice memo

curl https://api.blujay.io/v1/chats/chat_abc123/messages \
  -H "Authorization: Bearer blu_your_api_key" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: welcome-memo-7731" \
  -d '{
    "message": {
      "parts": [
        { "type": "audio", "attachment_id": "att_abc123" }
      ]
    }
  }'

{
  "status": "success",
  "data": {
    "chat_id": "chat_abc123",
    "message": {
      "id": "msg_jkl012",
      "direction": "outbound",
      "delivery_status": "accepted",
      "preferred_service": null,
      "service": null,
      "from": "+15555550100",
      "to": ["+15555550123"],
      "created_at": "2026-10-14T17:12:00.000Z",
      "parts": [
        { "type": "audio", "attachment_id": "att_abc123" }
      ]
    }
  },
  "trace_id": "trc_4b8e2d10c7a9",
  "timestamp": "2026-10-14T17:12:00.000Z"
}

• The file must be audio: M4A/AAC, MP3, WAV, CAF, FLAC, Ogg or WebM audio. An attachment_id that isn’t an audio file returns 415 UNSUPPORTED_ATTACHMENT_TYPE; a URL that doesn’t serve audio, or audio that can’t be decoded, fails the message with that failure_code.
• Blujay stores and sends every voice memo as M4A (AAC). Other audio is converted into a copy the message owns; the part keeps your attachment_id, and your attachment stays as you uploaded it.
• An attachment that can’t be decoded returns 400 VOICE_MEMO_UNREADABLE. If the conversion can’t run right now, you get 503 VOICE_MEMO_PROCESSING_UNAVAILABLE; retry with the same Idempotency-Key.
• An audio part must be the only part in the message. A voice memo with a caption or a second file returns 400 VALIDATION_ERROR; send the text as its own message.
• Voice memos go out over iMessage or RCS. preferred_service: "SMS", or a group chat carried by SMS, returns 415 UNSUPPORTED_ATTACHMENT_TYPE. A direct message that can only reach the recipient by SMS fails with failure_code UNSUPPORTED_ATTACHMENT_TYPE and failure.code unsupported_content; Blujay never sends the audio as a plain file instead.
• Like any file, voice memos are rejected until the contact has replied (400 PRE_REPLY_CONTENT_BLOCKED). They need a chat Blujay already knows the service of: a direct chat with no messages yet, or one whose service is SMS, returns 415 UNSUPPORTED_ATTACHMENT_TYPE, and a voice memo can’t start a new group chat (400 VALIDATION_ERROR).
• The same upload and URL limits apply: 100 MiB for uploads, 10 MiB from a URL.

​

Voice memos in your own voice

“Leave Ava a voice memo in my voice saying I’m running 10 minutes late.”

​

Next steps