> ## Documentation Index
> Fetch the complete documentation index at: https://docs.roark.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# roark call create

> Create a call

Create a new call with recording, transcript, agents, and customers

```bash Synopsis theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark call create [options]
```

> [!NOTE]
>
> Calls `POST /v1/call`

## Options

**--recording-url** `string` *required*

URL of source recording (must be an accessible WAV, MP3, MP4, or OGG file). Can be a signed URL.

**--stereo-recording-url** `string`

URL of source stereo recording. Must be accessible. Can be a signed URL. Supported formats: WAV, MP3, MP4, OGG.

**--started-at** `string` *required*

When the call started (ISO 8601 format).

**--interface-type** `string` *required*

Interface type of the call (PHONE or WEB). One of `PHONE`, `WEB`

**--call-direction** `string` *required*

Direction of the call (INBOUND or OUTBOUND). One of `INBOUND`, `OUTBOUND`

**--ended-status** `string`

High-level call end status, indicating how the call terminated. One of `PARTICIPANTS_DID_NOT_SPEAK`, `AGENT_DID_NOT_ANSWER`, `AGENT_DID_NOT_SPEAK`, `AGENT_STOPPED_SPEAKING`, `AGENT_ENDED_CALL`, `AGENT_SAID_END_CALL_PHRASE`, `AGENT_TRANSFERRED_CALL`, `AGENT_BUSY`, `AGENT_ERROR`, `CUSTOMER_ENDED_CALL`, `VOICE_MAIL_REACHED`, `SILENCE_TIME_OUT`, `PHONE_CALL_PROVIDER_CONNECTION_ERROR`, `CUSTOMER_DID_NOT_ANSWER`, `CUSTOMER_DID_NOT_SPEAK`, `CUSTOMER_STOPPED_SPEAKING`, `CUSTOMER_BUSY`, `DIAL_ERROR`, `MAX_DURATION_REACHED`, `UNKNOWN`

**--transcript** `array`

List of transcript entries made during the call.

**--tool-invocations** `array`

List of tool invocations made during the call.

**--properties** `object`

Custom properties to include with the call. These can be used for filtering and will show in the call details page.

**--vapi-call-id** `string`

The Vapi call ID (UUID) to link this call with OpenTelemetry trace data from Vapi. Used for matching calls with OTEL traces.

**--livekit-room-id** `string`

The LiveKit Cloud room ID to link this call with OpenTelemetry trace data from LiveKit. Used for matching calls with OTEL traces.

**--external-id** `string`

A stable identifier from your own system (e.g. session ID, conversation ID) used to correlate this call with OpenTelemetry traces. Set the same value as a `roark.external_id` span or resource attribute on your traces and the matching trace will be linked automatically. Must be unique within a project.

**--agent** `object`

Single agent participating in the call. Use this for simpler API when you have only one agent.

**--agent.endpoint** `string`

Endpoint configuration for this agent (optional).

**--agent.prompt** `object`

Agent's prompt configuration (optional).

**--agents** `array`

Agents participating in the call. Each agent requires identification and prompt information.

**--customer** `object`

Single customer participating in the call. Use this for simpler API when you have only one customer.

**--customer.label** `string`

Label to identify this customer in the transcript (e.g., "speaker-01", "speaker-02").

**--customer.phone-number-e164** `string` *required*

Customer phone number in E.164 format (e.g., +14155551234).

**--customers** `array`

Customers participating in the call.

## Example

```bash theme={"theme":{"light":"everforest-light","dark":"everforest-dark"}}
roark call create --recording-url <value> --started-at <value> --interface-type <value> --call-direction <value> --customer.phone-number-e164 <value>
```

Every command also takes the [global options](/cli-reference/overview.md#global-options) and sets one
of the [exit codes](/cli-reference/overview.md#exit-codes).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.