> For the complete documentation index, see [llms.txt](https://help.getcustomeriq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.getcustomeriq.com/data-guides/other-integrations/zendesk.md).

# Zendesk

By connecting Zendesk you can find themes and track topics across all your tickets.

After connecting Zendesk you'll have a dedicated Zendesk folder

<figure><img src="/files/lkSlsyGx5sLctM17paiR" alt=""><figcaption><p>Folders automatically created by Hubspot</p></figcaption></figure>

### Step 1: Go to workspace settings

1. From workspace settings, go to [Apps and integrations](https://app.getcustomeriq.com/settings/integrations)
2. On the Zendesk card, select Configure

**Note**: You must be a Zendesk admin to connect this integration

### Step 2: Authenticate Zendesk

1. Under configuration, select Authenticate,&#x20;
2. You will need your Zendesk sub domain to authenticate. [Here's where to find it.](https://support.zendesk.com/hc/en-us/articles/4409381383578-Where-can-I-find-my-Zendesk-subdomain-)
3. Enter your user Zendesk email and password in the modal that pops up, select sign in, and grant the necessary permissions

<figure><img src="/files/UXHYfoTSTvEwzGMhvpUy" alt=""><figcaption><p>Zendesk configure modal</p></figcaption></figure>

<figure><img src="/files/gyfGJPawx3RYhbg6fwsf" alt=""><figcaption><p>Zendesk authentication modal</p></figcaption></figure>

### Step 3: Save configuration

1. After authentication, CustomerIQ will automatically configure a default folder to store your Zendesk tickets. You will see this reflected in the configuration modal.
2. Select Save

You're all set! Tickets will automatically start streaming from Zendesk. You can see this now by heading over to folders.

## Zendesk FAQ

#### How much data is pulled on the first sync?

After the first connection we sync any tickets created/updated in the last 30 days. For larger accounts on a free plan, this may use most or all of your free credits. You can track this usage in your workspace settings > billing > usage

#### How long until the first sync is ready for analysis?

This depends on the number of tickets in your account. For most accounts this initial data is ready for analysis in views in \~30 minutes. For larger accounts this could take a few hours. You can monitor the progress of your sync from folders.

#### When does data update?

We sync new data from your Zendesk account every 60 minutes. This includes updated threads to tickets.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.getcustomeriq.com/data-guides/other-integrations/zendesk.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.