Sign in
latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-08-142528921.8 MB

a884f7dcbfc3

Calling Webhooks

Stream status callback

Sent to your status_url when a background audio stream started with calling.stream changes state. params.state is streaming when the stream starts and finished when it ends.

Status callbacks are advisory, best-effort notifications — delivery can be delayed or fail silently, so don't gate time-critical actions on receiving one. See Status callback reliability.

postWebhookstreamStatusCallback

Payload

event_type'calling.call.stream' required

The type of event. Always calling.call.stream for stream status callbacks.

event_channelstring required

The channel the event was delivered on.

timestampnumber required

When the event was sent, as a Unix timestamp in seconds.

project_idstring uuid required

Universal Unique Identifier.

space_idstring uuid required

Universal Unique Identifier.

Example payload

{
  "event_type": "calling.call.stream",
  "event_channel": "swml:451ed9ff-e568-4222-8af9-4f9ab7428d09",
  "timestamp": 1777565701.5623918,
  "params": {
    "tag": "my-tag",
    "control_id": "stream-control-1",
    "state": "streaming",
    "url": "wss://example.com/stream",
    "name": "customer-support-recording"
  }
}

Response

Webhook received