> For the complete documentation index, see [llms.txt](https://docs.incidenthub.cloud/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incidenthub.cloud/incidenthub-documentation/channels/integration-for-zendesk.md).

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