Skip to main content
POST
Create conversation
Famulor 1.0 API (legacy). This page applies only to Famulor 1.0 (app.famulor.de) and is retained for legacy compatibility. For the current platform, use the Famulor 2.0 API reference.
Create a new conversation with your Famulor AI assistant. Use this endpoint to start a widget or test conversation and receive the initial history.

Request Body

string
required
UUID of the assistant that should handle the conversation
string
default:"widget"
Conversation type. Options: widget (paid) or test (free for development)
object
Custom variables injected into the assistant context (accessible via {{variable_name}})

Request Examples

Response Fields

boolean
required
Indicates whether the request succeeded
string
required
UUID of the created conversation; use it for subsequent messages
array
Initial conversation history. Empty if the assistant has no initial message.

Response Examples

Notes

  • type: "widget" conversations are billed; type: "test" is free for development.
  • Provide meaningful variables to personalize the assistant’s first reply.
  • Continue the chat with Send Message and fetch history with Get Conversation.