---
title: "Create conversation"
method: POST
path: "/conversations"
tags: ["Conversations"]
---

# Create conversation

`POST /conversations`

## Request body

- object
  - `userIdentifier` string, required — Unique identifier for the end-user (1-256 chars). Allowed characters: alphanumeric, underscore, hyphen, colon, period, at symbol.
  - `userContext` object — Optional context key-values for additional filtering/tenancy.

## Response `200`

Conversation created

- object
  - `id` string

## Changes

- **2026-01-21** `c0068facc07b` — 1 breaking, 1 info
  - added the new required request property `userIdentifier`
  - the request property `userContext` became optional
- **2026-01-15** `b59ae9e9a8ec` — 1 breaking, 1 warning
  - added the new required request property `userContext`
  - removed the request property `context`

[Change history](https://skmtc.dev/inconvoai/apis/inconvo-conversations-api/changes/conversations/post.md)

---

[API](https://skmtc.dev/inconvoai/apis/inconvo-conversations-api.md) · [All operations](https://skmtc.dev/inconvoai/apis/inconvo-conversations-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/inconvoai/inconvo-conversations-api/revisions/d97ebdf80ef8/schema)