---
title: Zendesk
description: >-
  Monitor ticket metrics, automate alerts, and enhance security with Zendesk and
  Datadog.
breadcrumbs: Docs > Integrations > Zendesk
---

# Zendesk
Supported OS Integration version1.0.0


## Overview{% #overview %}

Zendesk is a customer service and support ticket platform for receiving, tracking, and responding to inquiries from customers. Enable this integration to see ticket metrics in Datadog and to create and update tickets from Datadog.

Integrate with Zendesk to:

- Monitor and graph ticket count metrics by status, user, and satisfaction rating.
- Receive a Datadog event each time a new Zendesk ticket is opened.
- Create and update tickets using `@zendesk` mentions in monitor notifications.
- Collect [Audit logs](https://developer.zendesk.com/api-reference/ticketing/account-configuration/audit_logs/) to control your data retention and leverage [Cloud SIEM](https://app.datadoghq.com/security/home) detection rules.
- Visually replay user-facing issues with Zendesk and Datadog Session Replay

## Setup{% #setup %}

### Installation{% #installation %}

To install this integration generate a Zendesk API Token:

1. Navigate to the API settings page by clicking the *Admin* gear icon from the left menu, then selecting *API* from the *Channels* section of the menu item list.
1. Enable Token Access if it is not already enabled.
1. Click the plus symbol to create a new token.
1. Set the API Token description to something informative, such as "Datadog-Zendesk Integration".
1. Copy the API Token. ***Important***: You need to temporarily save this token, because it is hidden once saved.
1. Click *Save*.

To complete the integration, enter your information in [Datadog](https://app.datadoghq.com):

1. Navigate to the [Zendesk integration tile](https://app.datadoghq.com/account/settings#integrations/zendesk) and click on the *Configuration* tab.
1. Enter your Zendesk domain. This is the text that appears before `zendesk.com`. For example, if your Zendesk URL is `https://my-company.zendesk.com`, your domain is `my-company`.
1. Enter your Zendesk username.
1. Enter the Zendesk API Token you received in step 5 above.
1. Click the Install Integration button.

#### Zendesk RUM App installation{% #zendesk-rum-app-installation %}

Datadog [Real User Monitoring](https://docs.datadoghq.com/real_user_monitoring/) allows you to view user sessions for your app to understand the performance and errors for the end users, identify bottlenecks, and analyze user analytics trends over time.

The Datadog RUM app lets your support staff view recent Datadog RUM sessions linked to the user who created the currently selected Zendesk ticket.



1. Follow the [installation instructions](https://docs.datadoghq.com/integrations/zendesk/#installation) for the integration.
1. Navigate to the [Datadog RUM App](https://www.zendesk.com/marketplace/apps/support/993138/datadog/) in the Zendesk Marketplace and click `Install`.
1. Configure the installation settings for the app:
   1. Datadog API and Application keys can be found in your [organization settings](https://app.datadoghq.com/organization-settings/api-keys). Paste these keys respectively.
   1. Navigate to the [Zendesk integration tile](https://app.datadoghq.com/integrations/zendesk) and copy the `Secret Key` under the **RUM App Settings** tab. Paste this key under the `Secret Key` setting for the app.
   1. Enter your [Datadog site](https://docs.datadoghq.com/getting_started/site/). For example, `us1`, `eu1`, `us3`, `us5`, `ap1`, `ap2`, or `fed`.
1. Navigate to the [Zendesk integration tile](https://app.datadoghq.com/integrations/zendesk).
1. Under the **RUM App Settings** tab, pick a value for the user binding from the dropdown list. This is the user attribute that the app uses to query the RUM sessions from the Zendesk ticket requester.
1. Click **Save**.
1. Navigate to a Zendesk ticket on your account and click on the Datadog RUM sidebar app to view the user's RUM sessions.

## Data Collected{% #data-collected %}

### Metrics{% #metrics %}

|  |
|  |
| **zendesk.ticket.count**(gauge)        | The number of tickets per status.                                           |
| **zendesk.satisfaction.rating**(gauge) | The number of satisfaction ratings submitted today per rating and assignee. |
| **zendesk.tickets\_today**(gauge)      | The number of tickets opened and solved today (UTC).                        |
| **zendesk.recent\_tickets**(count)     | The rate of tickets opened and solved                                       |

### Events{% #events %}

This integration generates an event each time a new Zendesk ticket is opened.



### Service Checks{% #service-checks %}

The Zendesk integration does not include any service checks.

### Logs{% #logs %}

The Zendesk integration collects audit logs using the [Zendesk Audit Log API](https://www.zendesk.com/marketplace/apps/support/993138/datadog/).

**Note:** A Zendesk Enterprise plan is required to collect audit logs.

## Features{% #features %}

### Create tickets{% #create-tickets %}

You can create Zendesk tickets and assign them to a group. First add the group name in the Datadog [Zendesk integration tile](https://app.datadoghq.com/account/settings#integrations/zendesk), then use `@zendesk-group-name` in your Datadog monitors and annotations. For example, to create a ticket and assign it to the Zendesk group *Support*, add the group and use `@zendesk-support`.

## Troubleshooting{% #troubleshooting %}

Need help? Contact [Datadog support](https://docs.datadoghq.com/help/).

## Further Reading{% #further-reading %}

- [Visually replay user-facing issues with Zendesk and Datadog Session Replay](https://www.datadoghq.com/blog/zendesk-session-replay-integration/)
- [Zendesk](https://docs.datadoghq.com/integrations/zendesk/)