SIP dial-in and dial-out

Daily supports both SIP dial-in and SIP dial-out. See the overview for prerequisites and codec information.

SIP dial-in (audio only)

Single SIP endpoint

Set the sip room property to enable SIP dial-in:

curl --request POST \
  --url https://api.daily.co/v1/rooms/your-room-name \
  --header 'Authorization: Bearer $DAILY_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"properties": {"sip": {"sip_mode": "dial-in", "display_name": "SIP Participant"}}}'

The response includes a read-only sip_uri.endpoint — the SIP address your client dials:

{
  "config": {
    "sip_uri": {
      "endpoint": "sip:123456780@example.sip.daily.co"
    },
    "sip": {
      "sip_mode": "dial-in",
      "display_name": "SIP Participant"
    }
  }
}

Set sip to null to disable SIP on a room.

Multiple SIP endpoints

Use num_endpoints to provision multiple SIP dial-in addresses. Each SIP and PSTN connection counts toward the max_sip_pstn_sessions_per_room limit (default: 5).

curl --request POST \
  --url https://api.daily.co/v1/rooms/your-room-name \
  --header 'Authorization: Bearer $DAILY_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"properties": {"sip": {"sip_mode": "dial-in", "display_name": "SIP Participant", "num_endpoints": 2}}}'

The response includes sip_uri.extra_endpoints with additional SIP addresses:

{
  "config": {
    "sip_uri": {
      "endpoint": "sip:123456780@example.sip.daily.co",
      "extra_endpoints": ["sip:abcdefg@example.sip.daily.co"]
    }
  }
}

SIP dial-in (audio and video)

Set video: true to enable video SIP dial-in. You can also specify codecs explicitly:

curl --request POST \
  --url https://api.daily.co/v1/rooms/your-room-name \
  --header 'Authorization: Bearer $DAILY_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "properties": {
      "sip": {
        "display_name": "sip-user",
        "sip_mode": "dial-in",
        "video": true,
        "codecs": {
          "audio": ["OPUS"],
          "video": ["H264"]
        }
      }
    }
  }'

If the remote party doesn’t support the specified codec, Daily transcodes the stream (transcoding charges apply). See our pricing page for details.

Dynamic display names

display_name is set at room creation time. To pass a name at dial time instead, append it as a URL-encoded query parameter on the SIP URI:

sip:123456780@example.sip.daily.co?x-daily_display_name=my%20user%20name

Use encodeURIComponent to encode the name. If x-daily_display_name is not passed, the room-level display_name is used.

Testing SIP dial-in

Below describes the SIP dial-in flow for a room with one SIP endpoint. For multiple endpoints, the flow is the same but with additional dialin-ready events and SIP URIs.

A session starts and the SIP worker registers with the SIP network.
The dialin-ready event fires for each registered SIP URI.
After dialin-ready, your SIP client dials the sip_uri.endpoint.

Notes:

Each sip_uri endpoint can only be used by one SIP client at a time.
After a disconnect, the same sip_uri can be redialed.
When the Daily session ends, all SIP connections are terminated.

SIP dial-out

A Daily room can dialout to a one or more "sipUri". You can initiate dial-out from the client SDK or REST API. See the overview for details on dial-out prerequisites and supported codecs. Dial out audio-only:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DAILY_API_KEY" \
  -XPOST -d '{"sipUri": "sip:user@example.calls.webex.com"}' \
  https://api.daily.co/v1/rooms/$ROOM_NAME/dialOut/start

Dial out with video enabled:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DAILY_API_KEY" \
  -XPOST -d '{"sipUri": "sip:user@example.calls.webex.com", "video": true, "codecs": {"audio": ["OPUS"], "video": ["H264"]}}' \
  https://api.daily.co/v1/rooms/$ROOM_NAME/dialOut/start

SIP URIs must be prefixed with sip:. You can also use startDialOut() from the client SDK.

SIP video layout

By default a SIP video participant sees the current speaker, one camera at a time, and hears everyone. A layout changes what Daily composites for them. Set it as videoSettings.layout on dialOut/start or startDialOut(), and as video_settings.layout in the sip room property for dial-in (SIP trunk room templates included).

Preset	What the SIP participant sees
`sip-active` (default)	The most recently active cameras, current speaker large. Up to 4 cameras (`maxCamStreams`).
`sip-grid`	Cameras in `participants.video` order, in a grid. Up to 4 cameras.
`sip-single`	One participant’s video (`videoParticipant`) and audio (`audioParticipant`, the same participant unless set).
`sip-portrait`	A 720x1280 composition (`width` up to 720, `height` up to 1280). `variant: "vertical"` stacks up to two cameras; `variant: "inset"` shows one full-frame and the other in a small tile, pinned with `mainParticipant` and `insetParticipant`.

Participant references. participants.video, participants.audio, videoParticipant, audioParticipant, mainParticipant and insetParticipant take a participant’s user_id (from their meeting token) or session id. The user_id is matched first, so a reference survives a rejoin and can name a participant who has not joined yet, which matters when the SIP call starts before the others arrive. participants.video and participants.audio also accept "*" (everyone) and "owners", and take up to 50 entries each. The SIP participant is named by the dial’s userId (user_id in the sip room property for dial-in). Their own camera is sent back only when a reference names it, never through "*", and their own audio is never sent back to them. Dial out to an interpreter who sees the patient full-frame and the doctor in a small tile:

curl -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DAILY_API_KEY" \
  -XPOST -d '{
    "sipUri": "sip:interpreter@relay.example.com",
    "video": true,
    "videoSettings": {
      "layout": {
        "preset": "sip-portrait",
        "variant": "inset",
        "mainParticipant": "patient-42",
        "insetParticipant": "doctor-7"
      }
    }
  }' \
  https://api.daily.co/v1/rooms/$ROOM_NAME/dialOut/start

Dial-in room whose callers see the room owners in a grid:

curl --request POST \
  --url https://api.daily.co/v1/rooms/your-room-name \
  --header 'Authorization: Bearer $DAILY_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "properties": {
      "sip": {
        "display_name": "sip-user",
        "sip_mode": "dial-in",
        "video": true,
        "video_settings": {
          "layout": { "preset": "sip-grid", "participants": { "video": ["owners"] } }
        }
      }
    }
  }'

See SIP video layout in the startDialOut() reference for every option and its limits.

Call transfers

For transferring SIP calls to another room or external SIP/PSTN endpoint, see the transfers guide.

Echo cancellation and noise suppression

Echo cancellation and noise suppression are device settings applied on the send side, the same as in any WebRTC call. See echo cancellation and noise suppression on phone and SIP audio in the overview.

Architecture & Monitoring

Troubleshooting

Privacy and Security

Scaling Calls

Features

SIP dial-in and dial-out

SIP dial-in (audio only)

Single SIP endpoint

Multiple SIP endpoints

SIP dial-in (audio and video)

Dynamic display names

Testing SIP dial-in

SIP dial-out

SIP video layout

Call transfers

Echo cancellation and noise suppression

​SIP dial-in (audio only)

​Single SIP endpoint

​Multiple SIP endpoints

​SIP dial-in (audio and video)

​Dynamic display names

​Testing SIP dial-in

​SIP dial-out

​SIP video layout

​Call transfers

​Echo cancellation and noise suppression

SIP dial-in (audio only)

Single SIP endpoint

Multiple SIP endpoints

SIP dial-in (audio and video)

Dynamic display names

Testing SIP dial-in

SIP dial-out

SIP video layout

Call transfers

Echo cancellation and noise suppression