Zendesk Integration Guide | PagerDuty

Zendesk + PagerDuty Integration Benefits

  • PagerDuty for Zendesk facilitates cross-team communication between ITOps, DevOps and your customer service teams. Communication silos are broken down, allowing you to mobilize the right resources across teams, in real-time, every time.
  • Installing the PagerDuty app for Zendesk will add an Incident Command Console to your Zendesk account. This console allows PagerDuty to create Zendesk tickets, sync priority and update tickets in real-time.

How it Works

  • Ticket events are sent from Zendesk in JSON format to PagerDuty. These events will trigger new or update existing incidents based on the integration configuration. This will notify on-call responders of the configured services.
  • Agents can manually trigger PagerDuty incidents from a Zendesk ticket, as well as associate Zendesk tickets with PagerDuty incidents.
  • In PagerDuty, you can also configure the Zendesk extension to sync updates bidirectionally.

Requirements

📘

Pricing Plan

The Zendesk integration is available to accounts on Customer Service Professional, Customer Service Business and Customer Service Digital Operations plans. Please contact our Sales Team if you would like to upgrade to a plan featuring the Zendesk integration.

  • In PagerDuty: An Admin base role is required to connect PagerDuty to Zendesk and create a PagerDuty API key. If you do not have this role, please reach out to an Admin or Account Owner within your organization to configure the integration.
  • In Zendesk: A Zendesk administrator will need to generate a Zendesk API key to configure the integration, install the marketplace app, and add any Webhooks or Triggers you choose to set up.

Version

This guide is for Zendesk v3, our most current integration version.

📘

Looking For a Different Version?

Our legacy Zendesk v1 integration guide is also available.

Integration Walkthrough

Add the Incident Command Console to Zendesk

In PagerDuty

  1. Navigate to Integrations Extensions.
  2. Under the Service Extensions menu, click +New Extension, then search and select Zendesk.
  3. Confirm that you want to add the app by clicking Open Zendesk Page on the popup window.
  4. Click the install the PagerDuty app link to open a new window where you can install the Incident Command Console for your users to manage incidents.

In Zendesk

  1. You will be directed to a new tab for the PagerDuty app in the Zendesk marketplace, click Install.
  2. Select your preferred account from the dropdown and then click Install.
Install integration

Install integration

  1. You will be directed to your Zendesk account. Click Install again to complete the installation of the app in the Zendesk marketplace.
Installation details

Installation details

  1. You will then see PagerDuty listed under Enabled Apps ( Apps and Integrations Enabled Apps).
PagerDuty app
  1. While still in the Zendesk admin settings, navigate to Apps and integrations APIs Zendesk API to generate a Zendesk API token. Copy the API token and paste it in a safe place for future use. Note: You will not have access to this key after this screen.
  2. Click Save to continue.

📘

Note

If you have a previous version of the Zendesk app, log in to Zendesk and navigate to Admin Go to Admin Center Apps and Integrations. Select the PagerDuty application, then click Update at the bottom of the page.

Configure Bi-Directional Workflows

Authorize the Integration

  1. In PagerDuty, return to the Zendesk Extension page and click Authorize Account to continue configuring the integration.
  2. Enter your Zendesk subdomain, Zendesk user email, and paste the Zendesk API token you just created in Zendesk. Click Authorize.
  3. Click Get PagerDuty API Key to generate a PagerDuty API key.
  4. On the API Access Keys page, click Create New API Key.
  5. Enter a Description (e.g., Zendesk API Key) and click Create Key.
  6. On the next screen, copy the API Key and paste it in a safe place for future use. Note: You will not have access to this key after this screen.
  7. Return to the Zendesk Extension page and enter your PagerDuty email address and the PagerDuty REST API key you just created. Click Save Changes to save the credentials entered.

Add Services

In order to configure workflow rules, or manually create a Zendesk ticket from a PagerDuty incident, you must first map your PagerDuty services to Zendesk.

  1. Select the Connections tab to connect PagerDuty services to Zendesk and build automation rules.
  2. Click Add Service to connect a service in the integration. Select a service from the dropdown and then click Add Service again.
  3. A pop-up will confirm that the service webhooks are correctly configured. If there are any errors, you can click the Check Webhooks button to recreate broken webhooks. Repeat steps 18-19 if you would like to add more services.

📘

Upgrading from V2 to V3

If you are upgrading from Zendesk v2 to Zendesk v3, clicking the Check webhooks button will list your existing Zendesk v2 triggers that will be deactivated and replaced with Zendesk v3 triggers. Please take note of any conditions that have been manually added to these Zendesk v2 triggers. You will need to manually copy these from the Inactive section in the Triggers settings to update the new PagerDuty v3 triggers in the Active section.

  1. Once a Service is added, we predefine some of the automation rules for you. If you would like to change how the integration's rules are configured, you can click the name of the Service to update these rules and follow instructions in the Synced Attributes and PagerDuty to Zendesk Automation sections. Otherwise, the integration configuration is now complete. If you would like to add more services: Repeat steps 18-21.
Connected service

Connected service

Configure Access Levels

In the Permissions tab, you can configure if different groups should have access to all or some actions for the Incident Command Console in the Zendesk platform.

  1. Navigate to the Permissions tab, and choose the abilities that your users should be allowed to perform in the Incident Command Console.

  2. If you’d like to add a new Group Ability, click Add Group Ability, choose the group you’d like to configure, and then select the actions they can take.

  3. Once finished, click Save Changes to save the permissions. Note: These permissions only apply to the Zendesk UI. If you’d like to restrict permissions in the PagerDuty Platform, please refer to our Advanced Permissions article.

Edit Access Levels

You can edit access levels after initial configuration.

  1. In PagerDuty, go to Integrations Extensions.
  2. Find the Zendesk extension under Extension Type and click Edit on the Zendesk Extension page.
  3. Under Authorized accounts, select your desired Zendesk account, then select the Permissions tab.
  4. Make your desired changes and click Save Changes.

Synced Attributes (Optional)

Synced attributes allow you to keep PagerDuty incidents and Zendesk tickets in sync. There are two attributes that sync: Priority and Notes.

To manage synced attributes:

  1. In PagerDuty, go to Integrations Extensions find the Zendesk extension under Extension Type and click Edit on the Zendesk Extension page.
  2. Under Authorized accounts, select your desired Zendesk account, then select the Connections tab click the name of the service.
  • To edit priority syncing: Click the dropdown under PagerDuty priority and select your preferred priority or delete syncing by clicking next to each priority level and click Save Changes.
  • To sync notes: Check the Sync notes checkbox and click Save Changes.

PagerDuty to Zendesk Automation (Optional)

To manage what changes are made to a Zendesk ticket when there is a change to a PagerDuty incident:

  1. In PagerDuty, go to Integrations Extensions find the Zendesk extension under Extension Type and click Edit on the Zendesk Extension page.

  2. Under Authorized accounts, select your desired Zendesk account, then select the Connections tab click the name of the service scroll to the section PagerDuty → Zendesk.

  3. From each Zendesk status dropdown, select what status the Zendesk ticket should change to when a PagerDuty incident changes status.

  4. Check the checkbox to Automatically create Zendesk tickets if you would like Zendesk tickets to be automatically created when there are incidents triggered for this service. If you do not select this option, you can still create a Zendesk ticket manually from an incident.

  5. Optionally select the following checkboxes to enable your preferred settings:

    • Set incident priority threshold: Zendesk tickets will be created for incidents with a specific Priority. Enable this setting and select your preferred threshold from the dropdown.
    • Sync description on ticket creation: Sync the PagerDuty incident with the Zendesk ticket comment upon Zendesk ticket creation.
  6. From the Zendesk ticket type dropdown, select which type of ticket you would like to PagerDuty incidents to create.

  7. Click Save Changes.

Zendesk to PagerDuty Automation (Optional)

To manage what changes are made to a PagerDuty incident when there is a change to a Zendesk ticket:

  1. In PagerDuty, go to Integrations Extensions, find the Zendesk extension under Extension Type and click Edit on the Zendesk Extension page.
  2. Under Authorized accounts, select your desired Zendesk account, select the Connections tab, click the service name and scroll to the Zendesk → PagerDuty section.
  3. From each PagerDuty status dropdown, select what status the PagerDuty incident should change to when a Zendesk ticket status changes.
  4. Check the checkbox to Automatically create PagerDuty incidents if you would like Zendesk to automatically create PagerDuty incidents when Zendesk tickets are created. If you do not select this option, you can manually create a PagerDuty incident from a Zendesk ticket.
    1. Note: This will add a new trigger marked PagerDuty and the Service ID in the connected Zendesk account. The default condition for this trigger is to create a PagerDuty incident when a Zendesk ticket is created. You can adjust this setting as required with the available Zendesk trigger conditions.
  5. Optionally select the following checkboxes to enable your preferred settings: 
    • Set PagerDuty Urgency on incident creation: PagerDuty Incidents will be created with the urgency setting selected; select the incident priority to map as low urgency.
    • Sync description on incident creation: Sync the comment of the Zendesk ticket with the PagerDuty incident description upon PagerDuty incident creation.
  6. Click Save Changes.

👍

Zendesk User Guide

Once initial configuration is complete, please read our Zendesk User Guide for instructions on how to use the integration.

Upgrade to Zendesk v3

🚧

Requirements

  • Support for Zendesk v2 ended on March 31, 2023. All PagerDuty customers using Zendesk v2 must upgrade to Zendesk v3 before it sunsets. There will be no new development on this version of the feature, and bug fixes will be handled case-by-case.
  • The upgrade needs to be completed by a PagerDuty Admin and Zendesk Admin.

Upgrade from Zendesk v2 to v3

  1. Complete the Zendesk v3 Integration Walkthrough steps and test the integration.
  2. After completing the walkthrough, confirm that your new PagerDuty triggers are set to notify active webhooks per Zendesk’s announcement.

Upgrade from Zendesk v1 to v3

  1. Complete the Zendesk v3 Integration Walkthrough steps and test the integration.
  2. In the Automatically Trigger PagerDuty Incidents From Zendesk section, in steps 8-10, create new or update your existing PagerDuty Triggers to Notify active webhooks instead of an email target.
  3. In PagerDuty, on the service(s) that have the Zendesk v1 email integration, navigate to the Integrations tab Delete Integration to remove the integration from PagerDuty.
  4. In Zendesk, navigate to Go to Admin Center Apps and Integrations Targets. On the target for the PagerDuty email integration, select Edit Delete to remove the email target.
  5. Then navigate to Go to Admin Center Objects and rules Business Rules Triggers to confirm that your existing PagerDuty triggers have been updated to Notify active webhooks. If new triggers were created, delete the older triggers here.

Zendesk User Guide

Please read our User Guide for more information about using the integration after it has been configured.

FAQ

Can I set the incident priority when automatically creating an incident from Zendesk?

Expand

At this time, we aren’t able to set the priority of an incident when creating it through the webhook/Trigger method. You can submit this as a feature request with our Support team.