Freshdesk
Connect Freshdesk to manage support tickets, contacts, companies, agents, time tracking, and the knowledge base.
You end up pasting your Freshdesk helpdesk domain and the personal API key revealed on your agent Profile Settings page. PopMCP sends it as HTTP Basic auth with the key as the username.
- Setup time
- 3 min
- Auth
- API credentials
- API base URL
- https://YOUR-DOMAIN.freshdesk.com/api/v2
- Rate limits
- Freshdesk publishes 3,000 API calls per hour on Blossom and Garden, and 5,000 per hour on Estate and Forest. Trial accounts default to 50 calls per minute.
Before you begin
- A Freshdesk account on any plan, including trials
- A verified agent login, because Freshdesk hides the API key until the agent's email is verified
- An agent whose role can see every group and ticket you want the AI to reach, because the key inherits that agent's permissions
Get your credentials
Note your helpdesk domain
Sign in to the agent portal and read the host in the address bar. In https://acme.freshdesk.com the domain is acme.
Open Profile Settings
Click your profile picture in the top-right corner of the agent portal and choose Profile Settings.
Dashboard
Unresolved tickets, overdue work and today's trends.
The menu drops from the avatar at the far right of the top bar.
Click View API key
On the right pane of the profile page, below the change password block, click View API key and complete the captcha.
Your profile
Agent details, signature, password and API key.
A captcha appears before the key is printed.
Paste the domain and key into PopMCP
Copy the revealed key, then paste the domain into Freshdesk domain and the key into API key in PopMCP. Click Connect.
Your profile
Resetting this key disconnects every app already using it.
Connect in PopMCP
Open your workspace, choose Freshdesk in the marketplace, and fill in the connect dialog:
| Field | What to enter |
|---|---|
| Freshdesk domaintext | The first part of your Freshdesk URL: https://<your-company>.freshdesk.com. You can paste the full URL and we'll extract the domain. This is the account the MCP is locked to. |
| API keysecret | In Freshdesk: click your profile picture (top-right) → Profile Settings → 'View API Key' (complete the captcha). The key inherits the permissions of that agent. Stored encrypted.Encrypted with AES-256-GCM on save and never shown again. |
PopMCP verifies the credential against Freshdesk immediately. On success the connection flips to Verified and its MCP tools are provisioned.
Verify it worked
PopMCP shows the Freshdesk connection as Connected against your domain, and asking it to list recent tickets returns real ticket subjects and IDs from your helpdesk.
Troubleshooting
401 Unauthorized on every call
Why: The key was copied with surrounding whitespace, or it belongs to a different Freshdesk domain than the one entered.
Fix: Re-copy the key from Profile Settings on the same helpdesk and confirm the domain field matches the host in the address bar.
The View API key button does not appear
Why: The agent's email address has not been verified. Freshdesk only shows the key to verified agents.
Fix: Open the Freshdesk verification email for that agent, or resend it from Admin then Agents, verify, then reload Profile Settings.
403 Forbidden on some tickets or groups
Why: The key inherits the creating agent's role, so a restricted-scope agent cannot see other groups' tickets.
Fix: Generate the key from an agent with a broader role, or widen that agent's ticket scope in Admin then Roles.
429 Too Many Requests
Why: The hourly API call budget for your plan was exhausted, often by a bulk export.
Fix: Wait for the window to reset and space out bulk operations. The Retry-After response header says how long to wait.