Getting started
Developer documentation
Everything in the dashboard is available over an HTTP API, and your workspace also speaks the Model Context Protocol so you can reach it from Claude, ChatGPT or your editor. Both use the same API keys.
- For
- Anyone integrating, and anyone evaluating whether they could
- You will need
- Nothing yet — an account when you want to make a call
- About
- 4 minutes to read
Quickstart
Your first API call in about five minutes, with curl and with both SDKs.
Authentication
API keys, scopes, and how to give an integration the narrowest access that works.
Claude, ChatGPT and editors
Connect your workspace over MCP and ask about it in plain language.
Webhooks
Get told when something happens, verify the signature, and replay a delivery.
Request logs
See every call your keys made, with status, latency and error code.
Retries, versioning and limits
Idempotency keys, the dated version header, rate-limit headers and error shapes.
API reference
Every endpoint, generated from the same spec the SDKs are built from.
The shape of it
One base URL, bearer authentication, JSON in and JSON out. A key created in the dashboard works on every endpoint your scopes allow — there is no separate developer account, no second signup, and no different billing. The API is part of your plan.
curl https://api.integrable.cloud/api/bots \
-H "Authorization: Bearer sk_live_your_key_here"What you can build
- Put your assistant's leads where you work. Poll conversations or subscribe to a webhook and write them into your own CRM.
- Keep the knowledge base in sync. Push documents from your CMS when they change, so the assistant never quotes a policy you retired.
- Report on it your way. Pull analytics into a spreadsheet, a dashboard, or a weekly email you already send.
- Answer questions about it in Claude. Connect over MCP and ask, rather than clicking.
SDKs
Both are generated from the same OpenAPI document this reference is built from, so the three cannot disagree about a shape.
npm install @integrable-cloud/sdk # TypeScript / Node 18+
pip install integrable-cloud # Python 3.10+They add the things a hand-rolled client usually gets wrong: an idempotency key on every mutation that is reused across that call's retries, jittered backoff that honours Retry-After, a distinct error class per condition, and cursor pagination as an iterator. Source: sdk-typescript and sdk-python.
Neither is required — the API is plain JSON over bearer auth, and the quickstart shows it with curl too.
Getting help
Every response carries an X-Request-ID. Quote it and we can find the exact call. Reach us at support@integrable.cloud.
Something here wrong or missing? Tell us — the documentation and the API are maintained by the same person, so a correction is a fix rather than a ticket.