Skip to main content
Prebuilt Custom These events fire during SIP/PSTN telephony sessions started with startDialOut() or triggered by inbound SIP dial-in. See the dial-in/dial-out guide for setup.

Dial-in Events

sipEndpoint and sipEndPointCurrent daily-js versions send the dial-in endpoint as sipEndpoint, the spelling in the TypeScript type definitions, and also under the old spelling sipEndPoint. sipEndPoint will be deprecated, so prefer sipEndpoint. Older versions send only sipEndPoint, so sipEndpoint is undefined there. This applies to dialin-ready, dialin-connected, dialin-stopped, dialin-warning, and details on dialin-error.To support both, read sipEndpoint and fall back to sipEndPoint:
In TypeScript, the types declare only sipEndpoint, so read the fallback with a cast: (ev as { sipEndPoint?: string }).sipEndPoint. Drop the fallback once your app no longer runs on older versions.The value starts with sip:, for example sip:my-room.0@my-domain.sip-us.daily.co. The room’s sip_uri.endpoint is the same address without the sip: prefix. Webhooks are not affected: they always use sip_endpoint.

dialin-ready

Fires once for each of the room’s SIP endpoints when it is ready to receive a call. Only emitted when the room has SIP dial-in configured.
string
Always "dialin-ready".
string
The ID of the call client instance that emitted this event.
string
The SIP endpoint URI ready to receive calls (e.g. "sip:room-name.0@your-domain.sip-us.daily.co"). Also sent as sipEndPoint, which will be deprecated, and the only key on older daily-js versions; see sipEndpoint and sipEndPoint.
string
The SIP provider: 'signalwire' or 'daily'. See SIP providers.

dialin-connected

Fires when a SIP or PSTN caller has connected to the Daily room and both endpoints are negotiating media.
dialin-connected does not mean media has started flowing — it means the connection request was received and media negotiation is underway.
string
Always "dialin-connected".
string
The ID of the call client instance that emitted this event.
string
Session ID of the dial-in participant.
string
The call ID of the call leg. On the Daily SIP provider this is the SIP Call-ID; on SignalWire it is SignalWire’s SID for the SIP leg between Daily and SignalWire. To match events for the same call, use sessionId.
string
The SIP provider: 'signalwire' or 'daily'. See SIP providers.
string
Optional user ID associated with the session.
string
Optional SIP From address of the caller.
string
Optional SIP endpoint that received the call. Also sent as sipEndPoint, which will be deprecated; see sipEndpoint and sipEndPoint.
object
Optional SIP headers from the incoming request.
string
Optional trace ID for debugging.

dialin-stopped

Fires when a SIP or PSTN session ends — either the remote end disconnected or the call was terminated.
string
Always "dialin-stopped".
string
The ID of the call client instance that emitted this event.
string
Session ID of the participant whose session ended.
string
The SIP provider: 'signalwire' or 'daily'. See SIP providers.
string
Optional user ID associated with the session.
string
Optional SIP From address of the caller.
string
Optional SIP endpoint that received the call. Also sent as sipEndPoint, which will be deprecated; see sipEndpoint and sipEndPoint.
object
Optional SIP headers.
string
The call ID of the call leg, if available. On the Daily SIP provider this is the SIP Call-ID; on SignalWire it is SignalWire’s SID for the SIP leg between Daily and SignalWire. To match events for the same call, use sessionId.
string
Optional trace ID for debugging.

dialin-error

Fires when a fatal error occurs in the dial-in pipeline — for example, an SDP negotiation failure.
string
Always "dialin-error".
string
The ID of the call client instance that emitted this event.
string
Human-readable error description.
string
Session ID of the affected participant. Absent when type is 'start-failed', because no session was created.
string
The SIP provider: 'signalwire' or 'daily'. See SIP providers.
string
Optional error classification. Currently only 'start-failed'.
string
Optional user ID.
string
The call ID of the call leg, if available. On the Daily SIP provider this is the SIP Call-ID; on SignalWire it is SignalWire’s SID for the SIP leg between Daily and SignalWire. To match events for the same call, use sessionId.
object
Optional details object. May contain sipEndpoint (also sent as sipEndPoint, which will be deprecated; see sipEndpoint and sipEndPoint), plus sipStatusCode (number) and sipReasonPhrase (string): the status code and reason phrase of the rejected SIP request (for dial-in, the REGISTER). Present only when the failure was a SIP rejection. A 408 or 503 may be generated locally on a timeout or transport failure rather than sent by the far end.
string
Optional trace ID for debugging.

dialin-warning

Fires for non-fatal dial-in errors, such as when a requested codec is unavailable and a fallback is applied.
string
Always "dialin-warning".
string
The ID of the call client instance that emitted this event.
string
Human-readable description of the warning.
string
Session ID of the affected participant.
string
The SIP provider: 'signalwire' or 'daily'. See SIP providers.
string
Optional user ID associated with the session.
string
Optional SIP From address of the caller.
string
Optional SIP endpoint that received the call. Also sent as sipEndPoint, which will be deprecated; see sipEndpoint and sipEndPoint.
string
The call ID of the call leg, if available. On the Daily SIP provider this is the SIP Call-ID; on SignalWire it is SignalWire’s SID for the SIP leg between Daily and SignalWire. To match events for the same call, use sessionId.

Dial-out Events

dialout-connected

Fires when Daily’s SIP leg for the dial-out is connected. With SignalWire, that is Daily’s leg to SignalWire, so the callee may still be ringing; wait for dialout-answered. With the Daily SIP provider, it is the call to the callee itself, so it fires only once the callee answers.
string
Always "dialout-connected".
string
The ID of the call client instance that emitted this event.
string
Session ID of the dial-out participant.
string
The call ID of the call leg. On the Daily SIP provider this is the SIP Call-ID; on SignalWire it is SignalWire’s SID for the SIP leg between Daily and SignalWire. To match events for the same call, use sessionId.
string
The SIP provider: 'signalwire' or 'daily'. See SIP providers.
string
Optional. Phone number in E.164 format or SIP URI of the remote party.
string
Optional. Originating address — phone number in E.164 or SIP URI.
string
Optional. The callerId passed to startDialOut(): the ID of a purchased phone number. The number presented to the remote party is in origin.
string
Optional. The callerName passed to startDialOut(): the name shown on the called device. SIP dial-out only.
string
Optional user ID associated with the session.
string
Optional trace ID for debugging.

dialout-answered

Fires when the remote party answers the outbound call. With SignalWire, it fires when the carrier reports the call answered. With the Daily SIP provider, it fires right after dialout-connected, because that event is only sent once the SIP INVITE is answered.
string
Always "dialout-answered".
string
The ID of the call client instance that emitted this event.
string
Session ID of the dial-out participant.
string
The call ID of the call leg. On the Daily SIP provider this is the SIP Call-ID; on SignalWire it is SignalWire’s SID for the SIP leg between Daily and SignalWire. To match events for the same call, use sessionId.
string
The SIP provider: 'signalwire' or 'daily'. See SIP providers.
string
Optional. Phone number in E.164 format or SIP URI of the remote party.
string
Optional. Originating address.
string
Optional. The callerId passed to startDialOut(): the ID of a purchased phone number. The number presented to the remote party is in origin.
string
Optional. The callerName passed to startDialOut(): the name shown on the called device. SIP dial-out only.

dialout-stopped

Fires when the dial-out session ends — the remote party hung up, the callee never answered (busy, declined, unreachable), or stopDialOut() was called. With the default "signalwire" provider an unanswered dial-out ends here, carrying the callee’s SIP status; with "daily" it fires dialout-error instead. See unanswered dial-outs by provider.
string
Always "dialout-stopped".
string
The ID of the call client instance that emitted this event.
string
Session ID of the dial-out participant.
string
The SIP provider: 'signalwire' or 'daily'. See SIP providers.
string
Optional. Destination phone number or SIP URI.
string
Optional. Originating address.
string
Optional. The callerId passed to startDialOut(): the ID of a purchased phone number. The number presented to the remote party is in origin.
string
Optional. The callerName passed to startDialOut(): the name shown on the called device. SIP dial-out only.
string
The call ID of the call leg, if available. On the Daily SIP provider this is the SIP Call-ID; on SignalWire it is SignalWire’s SID for the SIP leg between Daily and SignalWire. To match events for the same call, use sessionId.
number
Optional, "signalwire" provider only. The SIP status code with which the callee ended the call before answering, e.g. 486 (busy), 603 (declined), 404 (not found). Absent when the callee answered and later hung up, when the session was stopped through the API, and after a call transfer. Best-effort: it can also be absent for an unanswered call when SignalWire’s call record is not available in time, so a missing code does not mean the callee answered.
string
Optional. The standard reason phrase for sipStatusCode (RFC 3261), e.g. "Busy Here". It is derived from the code, not the phrase the callee sent. Present only with sipStatusCode.

dialout-error

Fires when a fatal error occurs in the dial-out pipeline.
string
Always "dialout-error".
string
The ID of the call client instance that emitted this event.
string
Human-readable error description.
string
The SIP provider: 'signalwire' or 'daily'. See SIP providers.
string
Optional session ID.
string
Optional user ID.
string
The call ID of the call leg, if available. On the Daily SIP provider this is the SIP Call-ID; on SignalWire it is SignalWire’s SID for the SIP leg between Daily and SignalWire. To match events for the same call, use sessionId.
object
Optional details object. May contain destination; sipStatusCode (number) and sipReasonPhrase (string), the status code and reason phrase of the rejected SIP request (INVITE, or REGISTER for providers that register before dialing), present only when the failure was a SIP rejection (a 408 or 503 may be generated locally on a timeout or transport failure rather than sent by the far end); and sipHeaders, a map of the custom X- SIP headers returned by the remote SIP endpoint when it rejected the dial-out, useful for debugging and error interpretation.
string
Optional trace ID for debugging.

dialout-warning

Fires for non-fatal dial-out errors, such as when a requested codec is unavailable and a fallback is applied.
string
Always "dialout-warning".
string
The ID of the call client instance that emitted this event.
string
Human-readable description of the warning.
string
The SIP provider: 'signalwire' or 'daily'. See SIP providers.
string
Optional session ID of the affected participant.
string
Optional. The callerId passed to startDialOut(): the ID of a purchased phone number. The number presented to the remote party is in origin.
string
Optional. The callerName passed to startDialOut(): the name shown on the called device. SIP dial-out only.

DTMF events

dtmf-event

Fires when a SIP or PSTN participant presses a key, on dial-in and dial-out legs alike. Every participant in the room receives it. See receiving DTMF for which SIP legs can deliver tones. There is no webhook for received tones.
string
Always "dtmf-event".
string
The ID of the call client instance that emitted this event.
string
Session ID of the SIP or PSTN participant that sent the tone.
string
The key pressed: 0–9, *, #, or A–D.
string
How the tone arrived: 'telephone-event' (RTP telephone event, Daily SIP provider only) or 'sip-info'.
number
The volume reported with the tone: the RFC 4733 volume for a telephone event, or the Volume field of the SIP INFO body (10 when the body has none).

See also