Skip to main content
startDialOut(options) The dialed participant joins the room as a regular participant. Requires the initiating participant to be an owner or admin.

Parameters

options: DailyStartDialoutSipOptions | DailyStartDialoutPhoneOptions Provide either sipUri (SIP) or phoneNumber (PSTN) — not both. Fields marked as SIP-only or PSTN-only are ignored when used with the wrong option type.

DailyStartDialoutSipOptions

string
The SIP URI to dial (e.g. sip:bob@example.com). Must conform to RFC 3261. Query parameters appended to the URI appear as X- SIP headers in the invite (e.g. sip:bob@example.com?X-myHeader=value).
string
Display name shown for the participant when they join. Defaults to the SIP username from the URI.
string
The name the called device shows for the incoming call: the display-name of the SIP From header. Independent of displayName, which names the participant inside the room. Max 70 characters; ", \ and control characters are rejected. Not allowed with phoneNumber. 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
Custom identifier for the participant (max 36 characters). See userId guidance.
boolean
Enable/disable SIP video.
DailyDialOutCodecs
Preferred codecs. The first entry in each array is used; if the remote party doesn’t support it, the stream is transcoded (transcoding charges may apply).
  • codecs.audio: 'PCMU' | 'OPUS' | 'G722' | 'PCMA'[]. Default: ['OPUS'].
  • codecs.video: 'H264' | 'VP8'[]. Default: ['H264'].
DailySipPstnParticipantPermissions
Controls which participants’ media the dialed-in SIP participant can receive. Uses the same canReceive shape as participant permissions.
'signalwire' | 'daily'
default:"'signalwire'"
The SIP provider for this dial-out. 'daily' dials the sipUri through the Daily SIP provider, the recommended choice for SIP dial-out. See SIP providers for what each provider supports.
provider applies to sipUri dial-out. With phoneNumber, only 'signalwire' is accepted and 'daily' throws. PSTN dial-out always uses SignalWire.

DailyStartDialoutPhoneOptions

string
The E.164 phone number to call (e.g. +12268077097).
string
Display name shown for the participant when they join. Defaults to the phone number.
string
Custom identifier for the participant (max 36 characters). See userId guidance.
string
The id of a purchased phone number on the domain, not the phone number itself. The phone number associated with this id is displayed as the caller ID on the called device. Defaults to the oldest purchased number on the domain.
string
Extension to dial after the call connects. Max 20 characters.
number
Seconds to wait after connecting before dialing the extension.
DailyDialOutCodecs
Preferred codecs. The first entry in each array is used; if the remote party doesn’t support it, the stream is transcoded (transcoding charges may apply).
  • codecs.audio: 'PCMU' | 'OPUS' | 'G722' | 'PCMA'[]. Default: ['PCMU', 'PCMA'].
  • codecs.video: not applicable for PSTN.
DailySipPstnParticipantPermissions
Controls which participants’ media the dialed-in PSTN participant can receive. Uses the same canReceive shape as participant permissions.

Return value

Returns a Promise that resolves to { session?: DailyDialOutSession }, where session.sessionId is the UUID identifying the initiated SIP/PSTN session.

Errors

  • NOT_ALLOWED — SIP/PSTN is not enabled for the room.
  • DIALOUT_IN_PROGRESS — A dial-out is already in progress.
  • TEMPORARILY_NOT_AVAILABLE — No workers available; try again shortly.

Examples

See also