acme.freshdesk.com), so each connected account supplies it as the domain field with its API key; the domain plugin option overrides it for single-account setups. Freshdesk API v2 does not support custom CNAMEs. The API key is sent using HTTP Basic authentication with X as the password.
Freshdesk applies per-minute account and API sublimits. List operations accept page (1-based) and per_page (maximum 100). A 429 includes Retry-After; automatic retries are limited to safe GET requests.
Ticket create/update/reply, note creation, contact avatar create/update, conversation updates, and outbound email with attachments accept { filename, contentType, base64 } entries and send multipart/form-data. Contact and company imports take one CSV the same way. Contact avatars use the avatar file part, imports use file, and the other upload routes use attachments[]. Object fields in a multipart request go out as bracketed parts (custom_fields[cf_name], fields[name]).
Pass path parameters in pathParams under their camelCase names ([ticket_id] becomes ticketId) and each route’s documented request fields through its body object. Each route’s input schema lists its own path parameters and body fields, and the plugin validates field names and primitive types; tenant-defined custom_fields and nested object values remain open JSON. Responses are validated as JSON values to preserve optional embeds and custom fields; consult the linked route for resource-specific response fields.
The plugin covers the documented v2 REST routes. Freshdesk marks v1 deprecated/restricted for new users. No webhook delivery contract is documented here.
What you get:
- 256 typed API operations
Setup
1
Install
2
Add the plugin
corsair.ts
multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.3
Choose authentication
- API Key (Recommended)
Store the Freshdesk API key before the first call: More: API Key
pnpm corsair setup --plugin=freshdesk --tenant=acme api_key=<your-key> (leave out --tenant without multiTenancy), or pass it as key in the plugin options. With Hub, each tenant enters their own key on the connect page. See API key auth.Each connected account stores its own Freshdesk hostname (the domain field) next to its API key: pnpm corsair setup --plugin=freshdesk --tenant=acme domain=acme.freshdesk.com, or the connect page with Hub. Set the domain option only for a single-account setup; it overrides the stored value.4
Connect a tenant
Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.
Example API calls
List recent ticketsWhat’s next
API reference
Every
freshdesk.api.* operation with input and output types.Connect / OAuth
createLink, Hub delivery, and tenant connect flows.
Use with agents
Expose this plugin’s operations as MCP tools.