# create_call

Source: <https://everruns.com/docs/api/operations/create_call/>

POST

/v1/sessions/{session\_id}/voice/calls

Select code samplecURL (shell:curl)

```js
const url = 'https://app.everruns.com/api/v1/sessions/example/voice/calls';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"channel_id":"appchan_01933b5a000070008000000000000001","provider_id":"prov_01h…","sdp":"example"}'
};


try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```sh
curl --request POST \
  --url https://app.everruns.com/api/v1/sessions/example/voice/calls \
  --header 'Content-Type: application/json' \
  --data '{ "channel_id": "appchan_01933b5a000070008000000000000001", "provider_id": "prov_01h…", "sdp": "example" }'
```

* Production APIapp.everruns.com/api/v1/sessions/{session\_id}/voice/calls

Start a voice call on a session (the chat microphone). Uses the settings of a voice channel of the session’s agent.

## Parameters

### Path Parameters

**session\_id**

required

string

## Request Bodyrequired

Media typeapplication/json

Request body for a session voice call (the chat microphone).

object

**channel\_id**

Voice channel whose settings the call uses (`appchan_…`). Must belong to the session’s agent. When omitted, the agent’s first voice channel is used, or the defaults when it has none.

string | null

##### Example

```plaintext
appchan_01933b5a000070008000000000000001
```

**provider\_id**

Realtime provider binding: the public id of the provider connection that serves the call (`prov_…`). When omitted, the org’s default (or single) realtime provider is used.

string | null

##### Example

```plaintext
prov_01h…
```

**sdp**

required

The browser’s WebRTC SDP offer.

string

## Responses

### 200

Realtime WebRTC call started

Media typeapplication/json

A started voice call.

object

**answer\_sdp**

required

SDP answer that completes the browser’s WebRTC handshake.

string

**channel\_id**

Voice channel whose settings the call uses, when there is one.

string | null

**expires\_at**

required

When the call’s lease expires (RFC 3339).

string format: date-time

**model**

required

Speech model.

string

**provider**

required

Realtime provider type serving the call (e.g. `openai`).

string

**provider\_call\_id**

Provider-side call identifier.

string | null

**voice**

required

Provider voice.

string

**voice\_connection\_id**

required

Prefixed public identifier of the voice connection.

string

##### Examplegenerated

```json
{
  "answer_sdp": "example",
  "channel_id": "example",
  "expires_at": "2026-04-15T12:00:00Z",
  "model": "example",
  "provider": "example",
  "provider_call_id": "example",
  "voice": "example",
  "voice_connection_id": "example"
}
```