Authentication

All API requests require an API key. Generate one in Settings > API Keys.

Include it in the Authorization header:

Authorization: Bearer YOUR_API_KEY

API keys are scoped to your organisation. Rate limit: 60 requests per minute.

Base URL

https://app.tonicdesk.com/api/v1

List endpoints return paginated results. Use page and per_page query parameters:

GET /api/v1/contacts?page=1&per_page=25

Response includes pagination metadata:

{
  "data": [...],
  "total": 150,
  "page": 1,
  "per_page": 25,
  "pages": 6
}