Freshdesk

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

  • Availability: Experimental (how to enable).
  • Authentication: Basic auth.
  • Connection: HTTP Basic auth with FRESHDESK_API_KEY as the username and FRESHDESK_API_PASSWORD as the password.
  • Provider documentation: Authentication reference.

Credentials

Set these per environment. See Connect an integration.

VariableRequiredDescription
FRESHDESK_API_KEYYesFreshdesk API key (used as the HTTP Basic username), from Profile Settings → View API Key Docs.
FRESHDESK_API_PASSWORDNoHTTP Basic password for Freshdesk - leave as the default 'X'; Freshdesk authenticates with the API key as username and a dummy password Docs.

Setup

  1. Create a Freshdesk account: Sign up at https://www.freshdesk.com/ - the free plan or a trial works for testing. Note your subdomain (yourcompany in yourcompany.freshdesk.com).
  2. Find your API key: In Freshdesk, click your profile picture → Profile Settings, then reveal 'Your API Key' on the right side.
  3. Set environment variables: Add FRESHDESK_API_KEY to your .env. Leave FRESHDESK_API_PASSWORD unset (it defaults to 'X') - Freshdesk uses HTTP Basic auth with the API key as the username and a dummy password.
  4. Verify access: Run the List Tickets tool with your subdomain as the domain parameter.

Provider notes

  • Freshdesk does not use OAuth for its REST API; HTTP Basic with the personal API key is the official method
  • The API key inherits the permissions of the agent it belongs to
  • All endpoints are per-account: https://<domain>.freshdesk.com/api/v2, HTTPS only

Provider API reference.

Tools

ToolAccessDescription
List Tickets<br /><code className="reference-identifier">freshdesk__list_tickets</code>ReadList tickets
Get Ticket<br /><code className="reference-identifier">freshdesk__get_ticket</code>ReadGet ticket
Create Ticket<br /><code className="reference-identifier">freshdesk__create_ticket</code>WriteCreate ticket
Update Ticket<br /><code className="reference-identifier">freshdesk__update_ticket</code>WriteUpdate ticket
List Contacts<br /><code className="reference-identifier">freshdesk__list_contacts</code>ReadList contacts

Verify the connection

Call a read tool such as freshdesk__list_tickets with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.