---
title: "POST /v1/conversation/chat/create"
method: POST
path: "/v1/conversation/chat/create"
tags: ["Conversation"]
---

# POST /v1/conversation/chat/create

`POST /v1/conversation/chat/create`

## Request body

- ConversationInitDTO
  - `customerId` string, required — The ID of the customer. If omitted, a new customer will be created.
  - `publicKey` string, required — The public key associated with this agent
  - `subject` string — The subject of the conversation.
  - `workflowId` string — The UUID of the workflow to trigger.
  - `variables` object — Value of variables on the conversation.

## Response `200`

- ConversationInitResponseDTO
  - `conversationId` string, required — The ID of the conversation
  - `createdAt` string, date-time, required — The timestamp of the when the conversation was created in our system.
  - `status` 'Unprocessed' | 'Processing' | 'Unhandled' | 'Triaged' | 'DraftResponse' | 'Responded' | 'Error' | 'Escalated' | 'EscalatedFailed' | 'Processed' | 'Ignored' | 'Tagged', required — The status of the conversation
  - `events` TicketEvent[], required — The events that have occurred in the conversation. Can be used for deriving more information about the conversation.
    - `id` string, required — The ID of the event
    - `type` 'ASSIGNED' | 'CLOSED' | 'ESCALATED' | 'ESCALATION_REQUEST' | 'PROCESSING_CANCELLED' | 'HOSTILE_MESSAGE' | 'NEW_TICKET' | 'CALL_ENDED', required — The type of the event
    - `data` object, required — Any specific data associated with the event
    - `createdAt` string, date-time, required — The timestamp of the event
  - `link` string, url, required — The url of the conversation in the Lorikeet dashboard
  - `tags` string[], required — The tags of the conversation

## Other responses

- `400` — The customer ID is missing

## Changes

> 52 revisions in range; 12 could not be searched.

- **2026-04-09** `2e7c56c5e808` — 5 warning
  - added the new `DraftResponse` enum value to the `status` response property for the response status `200`
  - added the new `EscalatedFailed` enum value to the `status` response property for the response status `200`
  - added the new `Ignored` enum value to the `status` response property for the response status `200`
  - added the new `Tagged` enum value to the `status` response property for the response status `200`
  - …1 more
- **2026-02-11** `b4f394f05daf` — 1 info
  - the endpoint scheme security `lorikeetClientId AND lorikeetSignatureAuthV1` was removed from the API

[Change history](https://skmtc.dev/optechai/apis/lorikeet-api/changes/v1/conversation/chat/create/post.md)

---

[API](https://skmtc.dev/optechai/apis/lorikeet-api.md) · [All operations](https://skmtc.dev/optechai/apis/lorikeet-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/optechai/lorikeet-api/revisions/789c7fa93584/schema)