> ## Documentation Index
> Fetch the complete documentation index at: https://serval-hannah-docs-custom-access.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Zendesk

## 1. About Zendesk

Zendesk is a customer service platform for support ticketing, knowledge management, and customer engagement. Connecting Zendesk to Serval enables automated ticket management and user provisioning workflows.

## 2. What the Zendesk integration enables

| Capability           | Description                                                                                      |
| -------------------- | ------------------------------------------------------------------------------------------------ |
| Automation workflows | Build workflows to streamline customer support processes, ticket escalation, and user management |

Anything defined in the [Zendesk API](https://developer.zendesk.com/api-reference/) can be accessed through Serval.

***

## 3. Zendesk configuration

### Prerequisites

* Admin permissions in your Zendesk instance
* Your Zendesk domain (e.g., `company.zendesk.com`)

### Create an API Token

1. In Zendesk, click the **gear icon** (Admin) in the left sidebar
2. Navigate to **Apps and integrations** → **API Tokens**

<img src="https://mintcdn.com/serval-hannah-docs-custom-access/EhjbiLY--yHnfZGh/images/integrations/zendesk/zendesk_apps_sidebar.png?fit=max&auto=format&n=EhjbiLY--yHnfZGh&q=85&s=89d18f4381e71a80cfff8eae89f2df7d" alt="Zendesk Apps and integrations sidebar" width="100" data-path="images/integrations/zendesk/zendesk_apps_sidebar.png" />

3. Enable **Token access** if not already enabled
4. Click **+ Add API token**

<img src="https://mintcdn.com/serval-hannah-docs-custom-access/EhjbiLY--yHnfZGh/images/integrations/zendesk/zendesk_add_api_token_button.png?fit=max&auto=format&n=EhjbiLY--yHnfZGh&q=85&s=76250699e69412c7cc6dbee3ca2eb06a" alt="Add API token button" width="2122" height="470" data-path="images/integrations/zendesk/zendesk_add_api_token_button.png" />

5. Add description: "Serval Integration"
6. Copy the generated token (shown only once)
7. Click **Save**

<img src="https://mintcdn.com/serval-hannah-docs-custom-access/EhjbiLY--yHnfZGh/images/integrations/zendesk/zendesk_add_api_token_screen.png?fit=max&auto=format&n=EhjbiLY--yHnfZGh&q=85&s=561d3f00db06905a6697bc2033f110a6" alt="Create API token screen" width="1454" height="690" data-path="images/integrations/zendesk/zendesk_add_api_token_screen.png" />

***

## 4. Serval Configuration

1. In Serval go to **Apps → Available → Zendesk → Connect**

2. Enter the following:

   | Field               | Description                                       |
   | ------------------- | ------------------------------------------------- |
   | Instance Name       | Friendly name (e.g., "Production Zendesk")        |
   | Service Instance ID | Your Zendesk domain (e.g., `company.zendesk.com`) |
   | Email Address       | Email of a Zendesk admin or agent                 |
   | API Token           | The API token from step 3                         |

3. Click **Save**

***

Need help? Contact **[support@serval.com](mailto:support@serval.com)** for assistance.