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

# Freshdesk

> Help desk and customer support

The **Freshdesk** integration lets your agents create and manage tickets, contacts, and conversations in Freshdesk for customer support.

## Prerequisites

* A **Freshdesk account** - [Sign up](https://www.freshdesk.com)
* A **Vatel AI organization** and at least **one agent**

## Configuration

### Step 1: Log in to Freshdesk

1. Go to your Freshdesk account (e.g. `yourcompany.freshdesk.com`) and log in.

<img src="https://mintcdn.com/devpro-38b0cd42/n-tXkZkofJjgZr-J/images/integrations/freshdesk-1.png?fit=max&auto=format&n=n-tXkZkofJjgZr-J&q=85&s=f0ec34eac8bfb77791919682d669c445" alt="Freshdesk homepage" width="2860" height="1346" data-path="images/integrations/freshdesk-1.png" />

### Step 2: Open Profile Settings

1. Click your **avatar** in the top-right corner of the page.
2. In the dropdown menu that appears, click **Profile settings**.

<img src="https://mintcdn.com/devpro-38b0cd42/n-tXkZkofJjgZr-J/images/integrations/freshdesk-2.png?fit=max&auto=format&n=n-tXkZkofJjgZr-J&q=85&s=f6eb3540be5421d05f0b92df564cb01d" alt="Profile settings dropdown" width="2860" height="1313" data-path="images/integrations/freshdesk-2.png" />

### Step 3: Reveal your API Key

1. On the **My Profile Settings** page, locate the **Your API Key** section on the right side of the screen.
2. Click **View API Key** to reveal it, then copy the key.

<img src="https://mintcdn.com/devpro-38b0cd42/n-tXkZkofJjgZr-J/images/integrations/freshdesk-3.png?fit=max&auto=format&n=n-tXkZkofJjgZr-J&q=85&s=783c23a8f23e852bf5f3af9f23156333" alt="Profile settings page" width="2860" height="1346" data-path="images/integrations/freshdesk-3.png" />

<img src="https://mintcdn.com/devpro-38b0cd42/n-tXkZkofJjgZr-J/images/integrations/freshdesk-4.png?fit=max&auto=format&n=n-tXkZkofJjgZr-J&q=85&s=28e8873def0bfc36dd282687c9b51d90" alt="API Key revealed" width="2860" height="1346" data-path="images/integrations/freshdesk-4.png" />

### Step 4: Connect the integration in Vatel

1. In the Vatel sidebar, click **Integrations**.
2. Click **Add Integration** in the top-right.
3. Select **FreshDesk**.
4. Set **Credential scope** to the agent you want to connect, or **Organization-wide (all agents)**.
5. In the **Username** field, paste your Freshdesk **API Key**.
6. In the **Password** field, enter `X` (Freshdesk uses the API key for authentication — the password is not used).
7. In the **Base URL** field, enter your Freshdesk account URL (e.g. `https://yourcompany.freshdesk.com`).
8. Click **Connect Integration**.

<img src="https://mintcdn.com/devpro-38b0cd42/n-tXkZkofJjgZr-J/images/integrations/freshdesk-5.png?fit=max&auto=format&n=n-tXkZkofJjgZr-J&q=85&s=48e6ab2e4d6067e00532f0d6bbaacb2f" alt="Connect Freshdesk in Vatel" width="2860" height="1454" data-path="images/integrations/freshdesk-5.png" />

### Step 5: Use the integration in your agent graph

1. Open an agent and go to its graph editor.
2. In the left sidebar under **Integrations**, you will see **FreshDesk** listed. Click it to add it as a node.
3. In the node panel that opens on the right, give the node a **Title**, then select an **Operation** from the dropdown (e.g. create ticket, get contact, update ticket).
4. Fill in any relevant field values or map them from graph variables.
5. Click **Save Changes**.
6. Start a call to test the node in your agent flow.