---
title: "rooms/:name/dialOut/start"
method: POST
path: "/rooms/{room_name}/dialOut/start"
tags: ["rooms"]
---

# rooms/:name/dialOut/start

`POST /rooms/{room_name}/dialOut/start`

Start a dial-out in a room

## Path parameters

- `room_name` string, required

## Request body

- DialoutProperties
  - `sipUri` string — sipUri to call. uri should start with `sip:`. Query parameters appended to the sipUri will appear as SIP Headers in the INTIVE message at the remote SIP endpoint. Headers must start with "X-", e.g. to append a header "myexampleHeader" it is appended to sipUri as "sip:<dialout_sip_uri>?X-header-1=val-1&X-header-2=val-2".
  - `phoneNumber` string — phone number to call. number must start with country code e.g `+1`
  - `extension` string — the extension to dial after dialed number is connected. e.g. `1234`
  - `waitBeforeExtensionDialSec` integer — number of seconds to wait before dialing the extension, once dialed number is connected.
  - `displayName` string — The sipUri or The phone participant is shown with this name in the web UI.
  - `userId` string — userId to assign to the participant. default `userId` is null.
  - `callerId` string — determine the phone number used for outbound call (i.e. phone number displayed on the called phone). [purchased phone](/products/rest-api/phone-numbers/purchased-phone-numbers)
  - `video` boolean — Enable SIP video in the room, only available for sipUri.
  - `videoSettings` object — Video encoding settings. Only applicable when `video` is `true`.
    - `width` integer — Video width in pixels. Default: 1280. Maximum: 1280.
    - `height` integer — Video height in pixels. Default: 720. Maximum: 720.
    - `fps` integer — Video frame rate. Default: 15. Maximum: 30.
    - `videoBitrate` integer — Video bitrate in kbps. Default: 900. Maximum: 1000.
  - `codecs` object — Specify the codecs to use for dial-out.
    - `audio` string[] — Specify the audio codecs to use for dial-out. Default codec is PCMU/PCMA. If the set codec is not supported by the remote party, the media stream will be transcoded and a transcoding charge will be applied. ['OPUS', 'G722', 'PCMU', 'PCMA']
    - `video` string[] — Specify the video codecs to use for dial-out. Default coded is VP8. If the set codec is not supported by the remote party, the media stream will be transcoded and a transcoding charge will be applied. ['H264', 'VP8'].

## Response `200`

200

## Other responses

- `400` — 400

---

[API](https://skmtc.net/daily/apis/daily-api.md) · [All operations](https://skmtc.net/daily/apis/daily-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/daily/daily-api/versions/225ed4870ea1/schema)