# Integration for Zendesk

You can integrate IncidentHub with Zendesk to receive notifications as support tickets in your Zendesk workspace.

IncidentHub will create tickets in your Zendesk workspace when any of the following happens:

1. An incident or maintenance is triggered (started).

IncidentHub does not send follow up notifications to Zendesk for the same incident or maintenance, including for updates and resolved events. It also does not send upcoming maintenance reminders to Zendesk.

## In Your Zendesk Account

1. Login to your Zendesk account and click on "View Profile" on your account icon's menu on the top right.
2. On the profile page, click on "Manage in Admin Center" which will open in a new window. The URL is usually similar to <https://mycompnay.zendesk.com/admin/home>.
3. On the left navigation bar, select "Apps and Integrations" -> "APIs" -> "API tokens".

<figure><img src="/files/xkiKdBCEDiHGV4s1aAD7" alt=""><figcaption></figcaption></figure>

You may have to enable token access if you have not done so before.

4. Generate a new token and copy it. You will need it in the subsequent steps.

## In Your IncidentHub Account

1. Login to your IncidentHub account and click on Channels -> Add -> Zendesk.
2. Add a Name and and a Description.
3. Under "Zendesk Workspace URL, put your workspace URL. It usually looks like <https://mycompany.zendesk.com> but it can be a custom domain also.
4. Under "Zendesk Email", enter the email of your Zendesk account from which you created the token.
5. Under "Zendesk Token", paste the token you created earlier.

<figure><img src="/files/w47NbgziBDbHXcThVf23" alt=""><figcaption></figcaption></figure>

1. To ensure that the details are valid and IncidentHub is able to connect to your Zendesk workspace, you can click on "Create a test ticket". This will create a test support ticket in your Zendesk workspace.
2. Click Save.

## Notification Example

A Zendesk support ticket created by IncidentHub looks like this:

<figure><img src="/files/fBu8jODbKYbdVtHTY4iI" alt=""><figcaption></figcaption></figure>


---

# 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.incidenthub.cloud/incidenthub-documentation/channels/integration-for-zendesk.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.