> ## 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.