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.

Call transfers

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

Architecture & Monitoring

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

Call transfers

​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

​Call transfers

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

Call transfers