API reference / Connected sessions / Send voice note
Send voice note
Send a voice note.
- Upstream
/im/v1/message/send- Access
- Growth and up
- Runs on
- FullPool
- Billing
- Failed calls are free
Authorization
x-api-keyheader · stringrequired
Your API key. Create one in API keys.
Body
Send JSON with content-type: application/json.
account_idstringrequired
A connected account, from /dash/sessions or POST /v1/account/import. For example acc_7Hq2.
conversation_idstringrequired
The conversation. For example 0:1:6970000000000000001:6970000000000000002.
audio_urlstringrequired
The audio file. For example https://example.com/voice.m4a.
Response
A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining.
Errors
Errors return a JSON body with a stable code and cost 0 credits. See Errors and retries.
Accounts you own only. Connected sessions are for accounts you own or are authorized to operate. Available on Growth and Scale.