> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Freshdesk

> Connect Freshdesk to your Atako agents — 13 read and 7 write actions.

Let your agents handle customer support in Freshdesk — create and update tickets, reply to customers, add notes, and manage contacts.

## Connection

* **Authentication**: API key.
* **Required settings**:
  * **Subdomain** — yourcompany in yourcompany.freshdesk.com

<Note>
  Log in to your Freshdesk portal → click your profile picture (top right) → Profile settings → find "Your API key" in the right sidebar (complete the captcha if asked) and copy it. The key inherits the permissions of your agent role — a role with ticket and contact access is enough.

  See [Freshdesk's documentation](https://support.freshdesk.com/support/solutions/articles/215517-how-to-find-your-api-key).
</Note>

## Read actions (13)

| Action | Description |
| - | - |
| `get_agent` | Fetch an agent by id. |
| `get_company` | Fetch a company by id. |
| `get_contact` | Fetch a contact by id. |
| `get_current_agent` | Fetch the agent whose API key is used (identity check). |
| `get_ticket` | Fetch a ticket by id, optionally embedding conversations, requester, company or stats. |
| `list_agents` | List support agents, filterable by email or availability state. |
| `list_companies` | List companies in the helpdesk. |
| `list_contacts` | List contacts, filterable by email, phone, company or state. |
| `list_groups` | List agent groups. |
| `list_ticket_conversations` | List all replies and notes on a ticket. |
| `list_tickets` | List tickets, filterable by view, requester, company or last-update time. |
| `search_contacts` | Search contacts with a Freshdesk query string, e.g. email:[jane@acme.com](mailto:jane@acme.com). |
| `search_tickets` | Search tickets with a Freshdesk query string, e.g. status:2 AND priority:4 (quotes added automatically). |

## Write actions (7)

| Action | Description |
| - | - |
| `create_contact` | Create a contact (requires a name plus at least an email, phone or mobile). |
| `create_ticket` | Create a support ticket (requester identified by email, phone or requester\_id). |
| `create_ticket_note` | Add a note to a ticket (private to agents by default). |
| `create_ticket_reply` | Send a public reply on a ticket (emailed to the requester). |
| `delete_ticket` | Delete a ticket (moved to trash, recoverable by an admin for 30 days). |
| `update_contact` | Update a contact (name, email, phone, company…). |
| `update_ticket` | Update a ticket (status, priority, assignee, subject, tags…). |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.

***

*Last reviewed against the provider API: July 2026.*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.