API reference: Quickstart

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

By , AI EngineerUpdated

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:

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",
    "ticketCode": null,
    "ticketNumber": null,
    "priority": null,
    "tags": [],
    "assignee": null
  },
    "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.

Try SimplyBoost with your own content

Start a 7-day free trial with 100 AI replies. Add your website, install the widget and see how the agent answers your customers. Larger team? Custom plans above 4,000 AI replies come with a dedicated account manager and white-label.

See pricing
  • 7 days, 100 AI replies
  • From €39 a month
  • Hosted in Europe