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

# Create conversation

`POST /conversations`

## Request

- Base URL: `https://app.famulor.de/api`
- URL: `https://app.famulor.de/api/conversations`
- Auth: none required

Start a new conversation session with a Famulor AI chatbot via API. Initialise context, user metadata and channel for WhatsApp, web chat or voice chat.

[Docs](https://docs.famulor.io/api-v1/ai-chatbot/create-conversation)

## Request body

- object
  - `assistant_id` string, required: UUID of the assistant that should handle the conversation
  - `type` string: Conversation type. Options: `widget` (paid) or `test` (free for development)
  - `variables` object: Custom variables injected into the assistant context (accessible via `{{variable_name}}`)
    - `customer_name` string: Name for greeting or personalization
    - `company` string: Company name to reference in replies
    - `source` string: Traffic or page source (e.g., `pricing_page`)

## Response `200`

OK

- object
  - `status` boolean, required: Indicates whether the request succeeded
  - `conversation_id` string, required: UUID of the created conversation; use it for subsequent messages
  - `history` object[]: Initial conversation history. Empty if the assistant has no initial message.
    - `role` string: Message role (`assistant` or `user`)
    - `content` string: Message text content

## Other responses

- `400`: Insufficient Balance
- `401`: Fehlender oder ungültiger API-Key.
- `404`: Assistant Not Found
- `422`: Die Anfrage ist inhaltlich ungültig.

---

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