Custom API Connector
Connect any internal system to show contextual data in tickets.
The custom API connector lets you pull data from any internal API — CRM, billing system, ERP — and display it in the ticket sidebar alongside the conversation.
How it works
When a ticket opens, Ticket0 calls your API endpoint with the customer's email (and optionally their external ID). Your endpoint returns a JSON response that Ticket0 renders in the sidebar.
Setting up a connector
- Go to Settings → Integrations → Custom connector → New
- Give it a name (e.g. "Internal CRM")
- Enter the endpoint URL — Ticket0 will
GETthis URL - Choose authentication: none, API key header, or bearer token
- Map the response fields to sidebar display labels
- Click Save and test
Request format
Ticket0 calls your endpoint with the following query parameters:
GET https://your-api.internal/customer?email=john@example.com&externalId=cus_123| Parameter | Description |
|---|---|
email | Customer's email address |
externalId | Customer's external ID (if set in Ticket0) |
Response format
Return a flat JSON object. Ticket0 renders key-value pairs in the sidebar:
{
"Plan": "Pro",
"MRR": "$299/mo",
"Account age": "14 months",
"Health score": "72/100"
}Nested objects are not displayed — flatten the data you want to show.
Authentication
Ticket0 supports three auth modes for your connector endpoint:
| Mode | How it works |
|---|---|
| None | No authentication header sent |
| API key header | Sends X-Api-Key: your_key |
| Bearer token | Sends Authorization: Bearer your_token |
Store credentials in Ticket0 — they are encrypted at rest and never exposed in the UI after saving.