# Freshdesk

Manage Freshdesk support: tickets, contacts, companies, agents, conversations. Exposes **26 actions** covering the full API surface
the agent needs - read and write.

## What it can do

| Method | What it does |
| --- | --- |
| `freshdesk_tickets_list` | List tickets - GET /tickets. |
| `freshdesk_ticket_get` | Get one ticket by ID - GET /tickets/{id}. |
| `freshdesk_ticket_create` | Create a ticket - POST /tickets. |
| `freshdesk_ticket_update` | Update a ticket - PUT /tickets/{id}. |
| `freshdesk_ticket_delete` | Delete a ticket - DELETE /tickets/{id}. |
| `freshdesk_contacts_list` | List contacts - GET /contacts. |
| `freshdesk_contact_get` | Get one contact by ID - GET /contacts/{id}. |
| `freshdesk_contact_create` | Create a contact - POST /contacts. |
| `freshdesk_contact_update` | Update a contact - PUT /contacts/{id}. |
| `freshdesk_contact_delete` | Delete a contact - DELETE /contacts/{id}. |
| `freshdesk_companies_list` | List companies - GET /companies. |
| `freshdesk_company_get` | Get one company by ID - GET /companies/{id}. |
| `freshdesk_company_create` | Create a company - POST /companies. |
| `freshdesk_company_update` | Update a company - PUT /companies/{id}. |
| `freshdesk_company_delete` | Delete a company - DELETE /companies/{id}. |
| `freshdesk_agents_list` | List agents - GET /agents. |
| `freshdesk_agent_get` | Get one agent by ID - GET /agents/{id}. |
| `freshdesk_groups_list` | List agent groups - GET /groups. |
| `freshdesk_group_get` | Get one group by ID - GET /groups/{id}. |
| `freshdesk_conversations_list` | List conversations for a ticket - GET /tickets/{id}/conversations. |
| `freshdesk_conversation_get` | Get one conversation by ID - GET /tickets/{ticket_id}/conversations/{id}. |
| `freshdesk_activities_list` | List activities for a resource - GET /{resource_type}s/{id}/activities. |
| `freshdesk_custom_fields_list` | List custom fields - GET /custom_fields. |
| `freshdesk_satisfaction_ratings_list` | List satisfaction ratings - GET /satisfaction_ratings. |
| `freshdesk_satisfaction_rating_get` | Get one satisfaction rating by ID - GET /satisfaction_ratings/{id}. |
| `freshdesk_tickets_update_bulk` | Update multiple tickets in one call - PUT /tickets. |

## How to get credentials

This connector uses an **API key / token**. Create one in the provider
dashboard, then paste it into FlyMyAI:

- **`FRESHDESK_DOMAIN`** - Your *.freshdesk.com subdomain (e.g. 'acme').
- **`FRESHDESK_API_KEY`** - Freshdesk - Profile settings - Your API Key.

## Fields to fill in FlyMyAI

| FlyMyAI field | Where it comes from |
| --- | --- |
| `FRESHDESK_DOMAIN` | Your *.freshdesk.com subdomain (e.g. 'acme'). |
| `FRESHDESK_API_KEY` | Freshdesk - Profile settings - Your API Key. |

## Troubleshooting

- **`401 Unauthorized` / `403 Forbidden`** - the token is wrong, expired, or missing a required scope - regenerate it.
- **`429 Too Many Requests`** - you hit the provider rate limit; retry after a short backoff.
- **Unexpected `4xx` on writes** - double-check required fields; the agent confirms before write actions.

## Links

- [Freshdesk API documentation](https://developers.freshdesk.com/api)