API Reference
Authentication
Authenticate API requests using Bearer tokens with the t0_ prefix.
The Ticket0 REST API uses bearer tokens for authentication. All API requests must be made over HTTPS.
Base URL: https://app.ticket0.ai/api/v1
Generating an API key
- Go to Settings → API keys
- Click New key
- Give the key a name and select the scopes it needs
- Copy the key — it is shown only once
API keys start with t0_.
Making authenticated requests
Include your key in the Authorization header:
curl https://app.ticket0.ai/api/v1/tickets \
-H "Authorization: Bearer t0_your_api_key"Scopes
Each API key is issued with one or more scopes. Request only the scopes your integration needs.
| Scope | Grants |
|---|---|
tickets:read | Read tickets and ticket details |
tickets:write | Create and update tickets |
messages:read | Read ticket messages |
messages:send | Send replies on tickets |
customers:read | Read customer records |
customers:write | Create and update customers |
admin | Full access to all resources and settings |
Errors
All errors return a consistent JSON body:
{
"error": {
"code": "unauthorized",
"message": "Invalid or missing API key"
}
}Common error codes:
| HTTP status | Code | Meaning |
|---|---|---|
400 | bad_request | Invalid request body or parameters |
401 | unauthorized | Missing or invalid API key |
403 | forbidden | API key lacks required scope |
404 | not_found | Resource not found |
429 | rate_limited | Too many requests |
500 | internal_error | Unexpected server error |
Quick start
# List your 10 most recent open tickets
curl "https://app.ticket0.ai/api/v1/tickets?status=open&limit=10" \
-H "Authorization: Bearer t0_your_api_key"