How to Connect Freshdesk to an AI Agent
Auth setup
1. Login to Freshdesk > Profile icon > Profile Settings. 2. Copy API Key. 3. Use Basic Auth: base64({api_key}:X). 4. Or pass api_key as username in basic auth.
Key facts
| Base URL | https://{domain}.freshdesk.com/api/v2/ |
|---|
| API version | v2 |
|---|
| Auth | API key authentication via Basic Auth. API key as username, 'X' as password. Get key from Profile Settings. |
|---|
| Request body | application/json |
|---|
| Pagination | page + per_page parameters. Link header with next page URL. Max 30 per page for tickets. |
|---|
| Rate limit | Tier-based: Free (50/min), Growth (200/min), Pro (400/min), Enterprise (700/min). |
|---|
| Error format | JSON: {"description":"Validation failed","errors":[{"field":"email","message":"...","code":"..."}]} |
|---|
Key endpoints
| Method | Path | Description |
|---|
GET | /tickets | List tickets |
POST | /tickets | Create a ticket |
PUT | /tickets/{id} | Update a ticket |
GET | /contacts | List contacts |
POST | /tickets/{id}/reply | Reply to a ticket |
Quickstart
GET /api/v2/tickets?per_page=10
Authorization: Basic {base64(api_key:X)}
Response: [{"id":1,"subject":"Help needed","status":2,"priority":1,...}]
Agent pitfalls & tips
- Basic Auth password is literally 'X' (the letter) — not empty, not the key again.
- Status values: 2=Open, 3=Pending, 4=Resolved, 5=Closed. Use numeric values.
- Priority: 1=Low, 2=Medium, 3=High, 4=Urgent. Numeric only.
- Include=stats adds response/resolution time stats to ticket responses.
- Custom fields use 'custom_fields' object with cf_fieldname keys.
Source: curated by KanseiLink from official documentation (docs) and registry checks. Last reviewed: 2026-04-07. Specs change — verify against the official docs before production use.
Frequently Asked Questions
What is Freshdesk's AEO score?
▼
Freshdesk has an AEO score of 0.60 and is rated BBB (Basic agent connectivity available). 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 Freshdesk AI-agent-ready?
▼
Freshdesk is currently connectable for AI agent use. API access is available but no dedicated MCP server has been published yet. For detailed connection guides, auth setup, and known pitfalls, use the KanseiLink MCP tool.
How does Freshdesk compare to other Customer Support services?
▼
In the Customer Support category, Freshdesk is rated BBB. 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 Freshdesk compares.
How can I integrate Freshdesk with an AI agent?
▼
The fastest way to integrate Freshdesk 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 Freshdesk?
▼
API key authentication via Basic Auth. API key as username, 'X' as password. Get key from Profile Settings. Setup: 1. Login to Freshdesk > Profile icon > Profile Settings. 2. Copy API Key. 3. Use Basic Auth: base64({api_key}:X). 4. Or pass api_key as username in basic auth.
What are Freshdesk's API rate limits?
▼
Tier-based: Free (50/min), Growth (200/min), Pro (400/min), Enterprise (700/min).