---
title: "Create Conversation"
method: POST
path: "/v1/conversations"
tags: ["conversations"]
---

# Create Conversation

`POST /v1/conversations`

## Request

- Base URL: `https://api.claims.zicron.ai`
- URL: `https://api.claims.zicron.ai/v1/conversations`
- Auth: none declared

Create a new conversation (schedule outbound or register inbound).

## Request body

- CreateConversationRequest
  - `claim_id` string, required
  - `script_id` string, nullable
  - `channel` string, required
  - `direction` string
  - `phone_number_to` string, nullable
  - `email_to` string, nullable
  - `scheduled_at` string, nullable
  - `task_context` string, nullable

## Response `201`

Successful Response

- ConversationSummary
  - `id` string, required
  - `claim_id` string, required
  - `channel` string, required
  - `direction` string, required
  - `status` string, required
  - `script_name` string, nullable
  - `phone_number_from` string, nullable
  - `phone_number_to` string, nullable
  - `email_from` string, nullable
  - `email_to` string, nullable
  - `started_at` string, nullable
  - `ended_at` string, nullable
  - `duration_seconds` integer, nullable
  - `sentiment` string, nullable
  - `summary` string, nullable
  - `created_at` string, required

## Other responses

- `422`: Validation Error

---

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