Skip to main content
POST
https://app.famulor.de/api/
/
conversations
/
{uuid}
/
messages
{
  "status": true,
  "message": "I'd be happy to help you schedule a demo! I have availability on Monday at 2 PM, Wednesday at 10 AM, or Friday at 3 PM. Which time works best for you?",
  "function_calls": []
}
Send a message to an existing Famulor conversation and receive the assistant’s reply including any function calls triggered during processing.

​
Path Parameters

​
uuid
string
required
UUID of the existing conversation

​
Request Body

​
message
string
required
User message to send (max 2000 characters)

​
Request Examples

cURL
curl -X POST "https://app.famulor.de/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7/messages" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "message": "I would like to schedule a demo for next week"
  }'
JavaScript
const response = await fetch(
  "https://app.famulor.de/api/conversations/7c9e6679-7425-40de-944b-e07fc1f90ae7/messages",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: "Bearer YOUR_API_KEY",
    },
    body: JSON.stringify({
      message: "I would like to schedule a demo for next week",
    }),
  }
);

const data = await response.json();
Python
import requests

conversation_id = "7c9e6679-7425-40de-944b-e07fc1f90ae7"
payload = {"message": "I would like to schedule a demo for next week"}

response = requests.post(
    f"https://app.famulor.de/api/conversations/{conversation_id}/messages",
    headers={
        "Content-Type": "application/json",
        "Authorization": "Bearer YOUR_API_KEY",
    },
    json=payload,
    timeout=10,
)

print(response.json())

​
Response Fields

​
status
boolean
required
Indicates whether the request succeeded
​
message
string
required
Assistant’s response text
​
function_calls
array
Function calls executed during this message (empty if none)

​
Response Examples

{
  "status": true,
  "message": "I'd be happy to help you schedule a demo! I have availability on Monday at 2 PM, Wednesday at 10 AM, or Friday at 3 PM. Which time works best for you?",
  "function_calls": []
}

​
Notes

  • Widget conversations: $0.01 per user message; test conversations are free.
  • Store the conversation UUID to resume chats later.
  • Show loading states since tool calls may take a few seconds.
  • Combine with Get Conversation for history and Create Conversation to start new chats.