# Setup Guide

### Prerequisites <a href="#prerequisites" id="prerequisites"></a>

To connect Zendesk Support, you need:

* Your Zendesk Support domain name. Your Zendesk Support domain is the beginning of your help desk URL. It's usually your company name, for example `dinmo` in `dinmo.zendesk.com`.
* A Zendesk account with an Administrator role. If you don't know if your account is an Administrator, proceed to the In Zendesk section.

### In Zendesk <a href="#inzendesk" id="inzendesk"></a>

1. To check if your account is an Administrator, log in to Zendesk and go to your profile.

   <div align="left"><img src="https://fivetran.com/static-assets-docs/_next/static/media/click-profile.2b0bf39c.webp" alt="Click profile" height="456" width="365"></div>
2. Verify that your user type is **Administrator**.

If you don't have an administrator login for Zendesk, you will need to ask someone else in your company who does.

### Setup instructions <a href="#setupinstructions" id="setupinstructions"></a>

1. In the connection setup form, enter the **Destination schema** name of your choice.
2. Enter your Zendesk Support **Domain** name.
3. In the **Historical sync time frame** drop-down menu, select the option on how you'd like the data to be synced.

   * If you choose **Sync all historical data** option, DinMo will sync all the historical data.
   * If you choose **Sync data from selected date** option, enter a date in the **Historical Sync Start Date** field. DinMo will sync the data from the specified date.

   The **Historical sync time frame** field is visible only if you have entered the **Domain** in the setup form.
4. In the **Max Zendesk API usage (%)** field, enter the maximum percentage of Zendesk API usage you want to allow for this connection. The default value is 90%.
5. Click **Authorize**. You will redirected to Zendesk's login page.
6. Log in to your Zendesk account and follow the instructions to authorize DinMo's access.

   We recommend logging in while in Incognito mode to ensure authorization of the correct account.
7. You will be redirected back to DinMo. Click **Save & Test**. DinMo will take it from here and sync your data from your Zendesk account.

<br>


---

# Agent Instructions: 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:

```
GET https://docs.dinmo.io/integrations/dinmo-ingest/zendesk-support/setup-guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.