{
"account_id": "acct_01japd271aeatb7txrzr2xj8sg",
"data": {
"call": {
"contact": {
"email": "dom@toretto.family",
"first_name": "Dominic",
"id": "ctc_01ja88cboqffhswjx8zbak3ykk",
"last_name": "Toretto",
"metadata": {
"car": "1970 Dodge Charger R/T"
},
"phone_number": "+18015551234"
},
"duration": 184,
"from": "+18015551234",
"id": "call_01jjnn7s0zfx5tdcsxjfy93et2",
"initiated_at": "2025-03-31T21:01:37Z",
"phone_number_id": "pn_01jsjwe4d9fx3tpymgtg958d9w",
"status": "completed",
"to": "+18015556789"
},
"duration": 124,
"id": "vml_01kfycac7rery81axwmpzcgpp8",
"recording_id": "rec_01kfyc9dgdec1avkgs7tng8htg"
},
"timestamp": "2024-10-21T23:29:41Z",
"type": "voicemail.received"
}Events
voicemail.received
Fires when a voicemail recording finishes processing and is available for download.
WEBHOOK
voicemailReceived
{
"account_id": "acct_01japd271aeatb7txrzr2xj8sg",
"data": {
"call": {
"contact": {
"email": "dom@toretto.family",
"first_name": "Dominic",
"id": "ctc_01ja88cboqffhswjx8zbak3ykk",
"last_name": "Toretto",
"metadata": {
"car": "1970 Dodge Charger R/T"
},
"phone_number": "+18015551234"
},
"duration": 184,
"from": "+18015551234",
"id": "call_01jjnn7s0zfx5tdcsxjfy93et2",
"initiated_at": "2025-03-31T21:01:37Z",
"phone_number_id": "pn_01jsjwe4d9fx3tpymgtg958d9w",
"status": "completed",
"to": "+18015556789"
},
"duration": 124,
"id": "vml_01kfycac7rery81axwmpzcgpp8",
"recording_id": "rec_01kfyc9dgdec1avkgs7tng8htg"
},
"timestamp": "2024-10-21T23:29:41Z",
"type": "voicemail.received"
}Fires when a voicemail recording finishes processing. Voicemails are a distinct recording type from regular call recordings — they are captured when a call goes unanswered and the caller leaves a message.
Common use case
Usevoicemail.received to notify staff of missed calls, trigger an SMS callback to the caller, or feed recordings into a transcription pipeline. Fetch the audio using GET /recordings/{recording_id}/file with the recording_id from the payload.Authorizations
Body
application/json
Response
200
Return a 200 status to indicate that the data was received successfully