Webhooks

Receive real-time events for calls, voicemail, and device activity

PBX sends webhook events for call lifecycle, voicemail, recording, and device registration changes. Configure webhook endpoints in the Webhooks & Events dashboard.

Event Types

Call Events

Event	Trigger
`pbx.call.started`	Call initiated (inbound, outbound, or internal)
`pbx.call.answered`	Call connected to destination
`pbx.call.completed`	Call ended
`pbx.call.transferred`	Call transferred to new destination
`pbx.call.recording.ready`	Recording processed and available for download

Voicemail Events

Event	Trigger
`pbx.voicemail.received`	New voicemail deposited with transcription

Queue Events

Event	Trigger
`pbx.queue.caller.joined`	Caller entered a queue
`pbx.queue.caller.connected`	Caller connected to an agent
`pbx.queue.caller.abandoned`	Caller hung up while waiting
`pbx.queue.caller.timeout`	Caller exceeded max wait time

Device Events

Event	Trigger
`pbx.extension.registered`	Phone/device registered to an extension
`pbx.extension.unregistered`	Phone/device unregistered

Payload Example

`pbx.call.completed`

{
  "event": "pbx.call.completed",
  "timestamp": "2026-03-26T14:35:00Z",
  "data": {
    "callId": "call_abc123",
    "direction": "inbound",
    "from": "5551234567",
    "to": "2395559876",
    "extensionNumber": "101",
    "extensionName": "Front Desk",
    "duration": 245,
    "status": "answered",
    "recordingId": "rec_xyz789",
    "queueId": null,
    "transferredFrom": null
  }
}

`pbx.voicemail.received`

{
  "event": "pbx.voicemail.received",
  "timestamp": "2026-03-26T14:36:00Z",
  "data": {
    "mailboxId": "vm_101",
    "extensionNumber": "101",
    "callerNumber": "5551234567",
    "duration": 32,
    "transcription": "Hi, this is John from XYZ Corp. I'm calling about the proposal we discussed...",
    "sentiment": "positive",
    "summary": "John from XYZ Corp following up on a proposal discussion.",
    "audioUrl": "https://pbx.dev/storage/vm_abc123.wav"
  }
}

Security

Webhook payloads are signed with HMAC-SHA256. Verify the X-Webhook-Signature header to ensure the request originated from do.dev. See Signature Verification for implementation details.