How to Connect Zendesk to an AI Agent
Auth setup
1. Admin Center > Apps and integrations > APIs > Zendesk API. 2. Enable Token Access. 3. Add API Token. 4. Use Basic Auth: base64({email}/token:{api_token}).
Key facts
| Base URL | https://{subdomain}.zendesk.com/api/v2/ |
|---|
| API version | v2 |
|---|
| Auth | Three methods: 1) API Token — generate in Admin > Channels > API. Use as {email}/token:{api_token} with Basic Auth. 2) OAuth 2.0 for third-party apps. 3) Password auth (not recommended). API Token is simplest for agents. |
|---|
| Token URL | https://{subdomain}.zendesk.com/oauth/tokens |
|---|
| Scopes | read,write |
|---|
| Request body | application/json |
|---|
| Pagination | cursor-based: response has 'meta.has_more' and 'links.next'. Use CBP (cursor-based pagination) for /tickets. Offset pagination being deprecated. |
|---|
| Rate limit | 400 requests/minute (Team), 700/min (Professional), 2500/min (Enterprise). HTTP 429 with Retry-After header. |
|---|
| Error format | JSON: {"error":"RecordNotFound","description":"Not found"} |
|---|
Key endpoints
| Method | Path | Description |
|---|
GET | /tickets | List tickets with filters (status, assignee, etc.) |
POST | /tickets | Create a new ticket |
PUT | /tickets/{id} | Update ticket (status, assignee, tags, etc.) |
GET | /search.json?query={query} | Search tickets, users, organizations |
GET | /users/{id} | Get user/requester details |
GET | /tickets/{id}/comments | Get ticket conversation history |
Quickstart
GET /api/v2/tickets?status=open&sort_by=created_at&sort_order=desc HTTP/1.1
Host: mycompany.zendesk.com
Authorization: Basic {base64(email/token:api_token)}
Accept: application/json
Response: {"tickets":[{"id":123,"subject":"ログインできない","status":"open","requester_id":456}]}
Agent pitfalls & tips
- Auth format is unusual: email/token:{api_token} (note the /token literal). Base64 encode the whole string for Basic Auth header.
- Base URL requires customer's subdomain: https://{subdomain}.zendesk.com. Ask user for their Zendesk subdomain.
- Search syntax: 'type:ticket status:open assignee:me' — supports complex queries with boolean operators.
- Ticket comments include both public replies and internal notes. Check 'public' field to distinguish.
- Sandbox environment available on Professional+ plans. Test API changes safely before production.
- Japanese-specific: many Japanese companies use Zendesk with Japanese locale — ticket subjects and comments will be in Japanese.
Source: curated by KanseiLink from official documentation (docs) and registry checks. Last reviewed: 2026-04-04. Specs change — verify against the official docs before production use.
Frequently Asked Questions
What is Zendesk's AEO score?
▼
Zendesk has an AEO score of 0.70 and is rated A (Functional agent integration). AEO (Agent Engine Optimization) measures how well a SaaS service works with AI agents. Scores range from 0.00 to 1.00, with grades from AAA (best) to D (not agent-ready).
Is Zendesk AI-agent-ready?
▼
Zendesk is currently connectable for AI agent use. Third-party MCP integrations are available for this service. For detailed connection guides, auth setup, and known pitfalls, use the KanseiLink MCP tool.
How does Zendesk compare to other Customer Support services?
▼
In the Customer Support category, Zendesk is rated A. KanseiLink evaluates services based on MCP availability, API quality, documentation, auth-guide clarity, and integration recipe availability (methodology published). Visit the full rankings at kansei-link.com to see how Zendesk compares.
How can I integrate Zendesk with an AI agent?
▼
The fastest way to integrate Zendesk with an AI agent is through KanseiLink MCP. Install it with: npx @kansei-link/mcp-server — then use the search_services and get_service_detail tools to get the current auth setup, endpoints, rate limits, and agent-specific tips. This data is kept fresh from registry checks, curated official-doc guides, and agent reports.
How do I authenticate with Zendesk?
▼
Three methods: 1) API Token — generate in Admin > Channels > API. Use as {email}/token:{api_token} with Basic Auth. 2) OAuth 2.0 for third-party apps. 3) Password auth (not recommended). API Token is simplest for agents. Setup: 1. Admin Center > Apps and integrations > APIs > Zendesk API. 2. Enable Token Access. 3. Add API Token. 4. Use Basic Auth: base64({email}/token:{api_token}).
What are Zendesk's API rate limits?
▼
400 requests/minute (Team), 700/min (Professional), 2500/min (Enterprise). HTTP 429 with Retry-After header.