---
title: "Create conversation from text"
method: POST
path: "/v1/dev/user/conversations"
tags: ["Conversations"]
---

# Create conversation from text

`POST /v1/dev/user/conversations`

Create a new conversation from text content. The text is processed through the full AI pipeline: discard detection, structured generation, action item extraction, memory extraction, app integration, and webhooks.

## Request body

- CreateConversation
  - `text` string, required — The conversation text/transcript.
  - `text_source` 'audio_transcript' | 'message' | 'other_text' — Source type.
  - `text_source_spec` string — Additional source info (e.g. `email`, `slack`, `whatsapp`).
  - `started_at` string, date-time — When conversation started (defaults to now).
  - `finished_at` string, date-time — When conversation finished.
  - `language` string — Language code.
  - `geolocation` GeolocationInput
    - `latitude` number
    - `longitude` number

## Response `200`

Conversation created.

- ConversationResponse
  - `id` string — Conversation ID.
  - `status` string — Processing status.
  - `discarded` boolean — Whether the conversation was discarded.

## Other responses

- `401` — Invalid or missing API key.
- `422` — Validation error.

## Changes

- **2026-03-24** `b791dc93aa91` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/basedhardware/apis/omi-developer-api/changes/v1/dev/user/conversations/post.md)

---

[API](https://skmtc.dev/basedhardware/apis/omi-developer-api.md) · [All operations](https://skmtc.dev/basedhardware/apis/omi-developer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/basedhardware/omi-developer-api/revisions/e3d644927120/schema)