Overview
API access, webhooks and realtime events for integrations
Last updated on
The Tillor API offers programmatic access to your organisation's data. Use API keys for authentication, webhooks for outgoing events, SSE or MQTT for realtime streaming, or MCP to connect AI tools such as Cursor, Claude, ChatGPT and Gemini to Tillor.
What can you build?
- Integrations - Connect Tillor to your own systems via the REST API
- Webhooks - Receive HTTP POST messages when events happen (invoice paid, customer created, etc.)
- Start automations - Start an automation from your own system with a POST to its incoming webhook
- Realtime dashboards - Stream events via SSE or MQTT for live updates in your application
- AI tools - Let Cursor, Claude, ChatGPT or Gemini call the API via MCP (
https://mcp.tillor.dev)
Get started quickly
- Create an API key in Tillor under Account > API Keys
- Send the key in the
x-api-keyheader with every request - Put your organisation ID in the path of organisation endpoints:
/orgs/org_abc123/...
Same events
Webhooks and SSE deliver exactly the same events. The difference: webhooks send an HTTP POST to your URL; SSE is a long-lived connection on which you receive events.
Useful links: API reference - OpenAPI
Scope: API keys are per account (all organisations); webhooks are per organisation.
Documentation for AI tools
You can also use this site as text for AI tools: /llms.txt (index), /llms-full.txt (all pages together), and per page by putting .mdx after the path (for example /ontwikkelaars/http.mdx). Ask AI (local) in the doc layout loads that full export (/llms-full.txt) into Chrome's built-in AI, so you do not have to be on a specific page.
See also
HTTP API
API keys, authentication, base URL and organisation context
MCP
Connect Cursor, Claude, ChatGPT or Gemini to Tillor via OAuth
External notifications
Register emails your own system sent to customers
Webhooks
Receive events via HTTP POST to your endpoint
Automations
The webhook message, the API request, incoming webhooks and the structure of a flow
SSE
Stream realtime events via Server-Sent Events
MQTT
Pub/sub via MQTT with strict topic access and JWT or static credentials
Mollie metadata
tillor namespace on Mollie payments
Website chat API
Your own chat UI via REST and SSE
Examples
Code and payload examples for HTTP, Webhooks and SSE