What the API does
The Chatonio API lets your own systems work with your support data programmatically. Over a versioned REST API you can list conversations, read and send messages, change a conversation’s status, and read your contacts. With webhooks you can have Chatonio notify your server the moment something happens — for example, when a customer sends a new message.
Base URL & versioning
All API requests go to the versioned base URL:
https://chatonio.com/api/v1/The current version is v1. New fields may be added to responses over time — write your integration to ignore unknown fields.
Authentication
The API is authenticated with a per-project API key sent as a bearer token:
Authorization: Bearer csk_live_your_key_hereTo create a key, open your project’s Developer settings (Project settings → Developer), click Create key, and copy the value. The full key is shown once — store it securely; you cannot see it again. Revoke a key any time from the same page.
Treat API keys like passwords. Never commit them to source control or expose them in a browser / mobile app — the API key grants full access to your project’s conversations.
Plan requirement
The API and webhooks are available on the Pro and Ultimate plans. If your plan doesn’t include it, requests return 403 with developer_api_not_available.
Quick start
List your most recently updated conversations:
curl https://chatonio.com/api/v1/conversations/ \
-H "Authorization: Bearer csk_live_your_key_here"Interactive reference
An auto-generated, always-current reference (OpenAPI / Swagger) lives at https://chatonio.com/api/v1/docs. It lists every endpoint, parameter, and response schema.