---
title: "Create Call"
method: POST
path: "/api/v1/calling/create-call"
tags: ["CallingService"]
---

# Create Call

`POST /api/v1/calling/create-call`

## Request body

- CreateCallRequest
  - `type` 'web_call' | 'outbound_call', required — Call type
  - `agent_id` string, required — Agent UUID
  - `from_phone_number` string, required — Caller ID (for outbound)
  - `to_phone_number` string, required — Destination phone (for outbound)
  - `metadata` object — Custom key-value metadata
  - `prompt_dynamic_variables` object — Variables for agent prompt

## Response `200`

Successful response

- CreateCallResponse
  - `success` boolean
  - `message` string
  - `access_token` string — LiveKit access token
  - `room_id` string — Room ID for the created call session
  - `session_id` string — Call session UUID
  - `url` string — LiveKit WebSocket URL

---

[API](https://skmtc.net/ravan/apis/agni-api.md) · [All operations](https://skmtc.net/ravan/apis/agni-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ravan/agni-api/revisions/48f45dc58534/schema)