Skip to main content
sipCallTransfer(options) Prebuilt Custom SIP-to-SIP, PSTN-to-PSTN, SIP-to-PSTN, and PSTN-to-SIP transfers are all supported. Requires the initiating participant to be an owner or admin. Use sipRefer() instead when Daily should exit the media path entirely after the transfer.
sipCallTransfer() is not supported for a session on the Daily SIP provider. It returns an error. Use sipRefer() for those sessions.
When transferring to an external SIP address or PSTN phone number, the call remains anchored on Daily. Both call connections stay active during the transfer period, and usage continues to be billed accordingly.

Parameters

string
required
The session_id of the SIP or PSTN participant to transfer.
string
required
The destination SIP address (e.g., sip:someone@sip.abc.com) or PSTN number (e.g., +16586574500) to transfer the call to.
string
The id of a purchased phone number to display as the caller ID, not the phone number itself. Only valid when transferring to a PSTN number.
string
The name the destination device shows for the incoming call: the display-name of the SIP From header. Only valid when toEndPoint is a SIP address, and not accepted by sipRefer(). Max 70 characters; ", \ and control characters are rejected. A back-to-back user agent (B2BUA) between Daily and the device decides what its own leg shows; see caller name on the called device.
string
Extension to dial after the destination connects. Only valid with a PSTN toEndPoint. Max 20 characters.
number
Seconds to wait after the destination connects before dialing the extension.

Return value

Returns a Promise<void>.

Examples

See also