# Integration for Freshdesk

You can integrate IncidentHub with Freshdesk to receive notifications as support tickets in your Freshdesk portal.

IncidentHub will create tickets in your Freshdesk portal when any of the following happens:

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

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

## In Your Freshdesk Account

1. Login to your Freshdesk portal and click on your profile picture on the top right corner.
2. Go to the "Profile Settings" page.
3. Your API key is available on the right-hand side of the page.
4. Copy the API Key - you will need it in the next step.

## In Your IncidentHub Account

1. Login to your IncidentHub account and click on Channels -> Add -> Freshdesk.
2. Add a Name and and a Description.
3. For "Freshdesk Portal URL", enter the domain of your Freshdesk portal. This usually looks like `https://mycompany.freshdesk.com`.
4. For "Freshdesk Requester Email", enter the email which you use to login to your Freshdesk account.
5. For "Freshdesk API Key", enter the API key you copied earlier.
6. To ensure that the details are valid and IncidentHub is able to connect to your Freshdesk portal, you can click on "Create a test ticket". This will create a test support ticket in your Freshdesk workspace.
7. Click Save.

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

## Notification Example

A Freshdesk support ticket created by IncidentHub looks like this:

<figure><img src="/files/pt1jFK6fTpMtfgr5Kowu" 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-freshdesk.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.