Webhook event reference

Subscribe to events when creating a webhook. Every delivery uses the envelope:

{
  "event_id":   "01HX...",
  "event_type": "sms.received",
  "api_version": "v1",
  "timestamp":  "2026-06-08T14:02:11Z",
  "data": { ... }
}

Available events

Event	When it fires
`sms.received`	An inbound SMS arrived on your gateway number. `data.from`, `data.to`, `data.body`.
`sms.sent`	The gateway device confirmed the outbound SMS was handed to the carrier.
`sms.delivered`	Carrier delivery receipt received.
`sms.failed`	Outbound SMS failed on the device.

Event	When it fires
`call.incoming`	An inbound call is ringing on your gateway number. `data.from` is the caller's number. No answer needed — let it ring and use `call.missed` as your verification signal.
`call.connected`	The call was answered (inbound or outbound).
`call.ended`	A connected call was hung up. Includes `data.duration_seconds` and `data.cost_usd`.
`call.missed`	The call rang and was not answered. Billed as 1 call event. Primary signal for missed-call verification.
`call.rejected`	The destination actively rejected the call. Billed as 1 call event.
`call.failed`	Outbound call failed to reach the carrier or device (not billed).

Event	When it fires
`number.assigned`	A number was provisioned to your account.
`number.released`	A number was released from your account.

Event	When it fires
`account.suspended`	Your account was suspended.
`account.balance.low`	Credit balance dropped below the low-balance threshold.