Skip to main content
Use Freshdesk through Corsair: one client, typed API calls. Every Freshdesk account has its own hostname (for example 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
With multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.
3

Choose authentication

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 tickets
Add a private note to a ticket
See the full list on the API page.

What’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.