# Freshdesk API Documentation

This is the complete API documentation for connecting to the Freshdesk API using MindCloud's Universal API.

MindCloud offers one normalized API to access 3,400+ apps from a single place. It centralizes authentication and normalizes app APIs so they are easier and more consistent to use.

## Quickstart

1. A **MindCloud account** — sign in or create an account at [MindCloud](https://app.mindcloud.co).
2. A **MindCloud API Key** — create one in [API Keys](https://app.mindcloud.co/user/api-keys). Keep it on your server.
3. At least one **Freshdesk connection** — create or choose one in [Connections](https://app.mindcloud.co/credentials). Note its `connectionId`.

```text
POST https://connect.mindcloud.co/v2/universal/apps/freshdesk/actions/{actionSlug}/run
```

## Freshdesk actions

- POST `create-company` Create Company
- POST `create-contact` Create Contact
- POST `create-note` Create Note
- POST `create-reply` Create Reply
- POST `create-ticket` Create Ticket
- DELETE `delete-company` Delete Company
- DELETE `delete-ticket` Delete Ticket
- GET `get-agent` Get Agent
- GET `get-company` Get Company
- GET `get-contact` Get Contact
- GET `get-currently-authenticated-agent` Get Currently Authenticated Agent
- GET `get-ticket` Get Ticket
- GET `list-agents` List Agents
- GET `list-companies` List Companies
- GET `list-contacts` List Contacts
- GET `list-ticket-conversations` List Ticket Conversations
- GET `list-ticket-time-entries` List Ticket Time Entries
- GET `list-tickets` List Tickets
- GET `search-tickets` Search Tickets
- DELETE `soft-delete-a-contact` Soft Delete a Contact
- PUT `update-company` Update Company
- PUT `update-contact` Update Contact
- PUT `update-conversation` Update Conversation
- PUT `update-ticket` Update Ticket