Quickstart. Your first answer in two requests.
Find your chatbot's ID, send it a question, and continue the conversation.
POST/chatbots/…/messages
{"message": "Do you ship to Belgium?"}201 Creatednew conversation
Yes. Next-day to Belgium, free over €50.
Shipping
1. Find your chatbot
curl https://get-api.simplyboost.io/api/v1/chatbots \
-H "Authorization: Bearer $SIMPLYBOOST_TOKEN"Copy the id of the chatbot you want to use from data.chatbots. The token needs chatbots:read.
2. Send a message
curl -X POST https://get-api.simplyboost.io/api/v1/chatbots/CHATBOT_ID/messages \
-H "Authorization: Bearer $SIMPLYBOOST_TOKEN" \
-H "Idempotency-Key: 7f9c2b1e-q1" \
-H "Content-Type: application/json" \
-d '{"message": "Do you ship to Belgium?"}'The response arrives when the answer is ready, usually within a few seconds. A new conversation returns 201 Created:
{
"ok": true,
"data": {
"conversation": {
"threadId": "3f0c9a52-6d1e-4b0a-9c51-0f3e2c7d8a14",
"chatbotId": "f45268b2-1980-470d-865d-5048a89aedce",
"channel": "api",
"mode": "ai",
"escalated": false,
"resolved": false,
"startedAt": "2026-10-07T09:30:00+00:00",
"lastMessageAt": "2026-10-07T09:30:04+00:00"
},
"message": {
"question": { "text": "Do you ship to Belgium?" },
"answer": { "text": "Yes. Next-day to Belgium, free over €50." },
"sources": [{ "title": "Shipping", "url": "https://yourshop.com/shipping", "type": "website" }],
"suggestedQuestions": ["How much is shipping to Belgium?"],
"attachments": []
}
},
"meta": { "requestId": "req_7c1e4b2a9f0d4e6c8b3a5d7f9e1c2b4a" }
}3. Continue the conversation
Send data.conversation.threadId back as threadId. The agent then has the earlier messages as context. A continued conversation returns 200 OK.
curl -X POST https://get-api.simplyboost.io/api/v1/chatbots/CHATBOT_ID/messages \
-H "Authorization: Bearer $SIMPLYBOOST_TOKEN" \
-H "Content-Type: application/json" \
-d '{"message": "How much is it otherwise?", "threadId": "THREAD_ID"}'Next: read Responses and errors, so your code handles every outcome.