---
title: "Create Voice Session"
method: POST
path: "/v1/voice/sessions"
tags: ["Voice Sessions"]
---

# Create Voice Session

`POST /v1/voice/sessions`

## Request

- Base URL: `https://api.call2me.app`
- URL: `https://api.call2me.app/v1/voice/sessions`
- Auth: HTTP bearer

Issue a LiveKit token for a headless AI voice session with an agent.

The developer connects their own LiveKit client with the returned token+url;
the voice-agent auto-joins and speaks as the agent. Billing accrues to the
agent owner's wallet based on call duration (via report_usage).

## Request body

- VoiceSessionRequest
  - `agent_id` string, required
  - `context` object, nullable: Optional prompt variables merged into room context.
  - `external_user_id` string, nullable: Your identifier for the end user.
  - `metadata` object, nullable: Free-form metadata attached to the session.
  - `max_duration_sec` integer, nullable: Server-side session time limit; the agent ends the call when reached.

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/call2me/apis/call2me-api.md) · [All operations](https://skmtc.dev/call2me/apis/call2me-api/llms.txt) · [OpenAPI document](https://skmtc.dev/call2me/apis/call2me-api/revisions/3951f9b7e47d?raw)