Developers

API Reference

Query your BotBuild chatbots from your own app, backend, or automation. Two endpoints, one header, no SDK required. REST API and webhooks are included on every paid plan (Starter and up) — nothing here is a locked add-on.

Authentication

Every request is authenticated via an X-API-Key header. Generate your key from Dashboard → API after signing up on a Starter, Pro, or Business plan. Treat it like a password — it grants full access to your chatbots — and regenerate it immediately if it's ever exposed.

Endpoints

GET/api/v1/chatbotsList all your active chatbots.

Request

curl https://api.botbuild.co/api/v1/chatbots \
  -H "X-API-Key: YOUR_API_KEY"

Response

[
  { "id": 1, "name": "Support Bot", "description": "..." },
  { "id": 2, "name": "Sales Bot",   "description": null  }
]
POST/api/v1/chat/{chatbot_id}Send a message and get a response.

Request

curl -X POST https://api.botbuild.co/api/v1/chat/1 \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "What are your pricing plans?",
    "history": [],
    "session_id": "optional-session-id"
  }'

Response

{
  "response": "We offer three plans: Starter at $29/mo...",
  "model": "claude",
  "chatbot_id": 1
}

Rate limits

The chat endpoint is limited to 60 requests per minute per account. The chatbots list endpoint is unthrottled.

Webhooks

Beyond this request/response API, every paid plan also includes outbound webhooks and Zapier support — push order/inventory events into a chatbot's context, or pull leads and conversations into your own systems. Configure these from Dashboard → Zapier once you're signed in.

Ready to generate a key and start building?

Start free — no credit card requiredView pricing