---
title: "PagerDuty integration"
description: "Connect Guardian to PagerDuty so actions can trigger PagerDuty services."
product: "Guardian"
edition: "Classic"
type: "workflow"
url: "https://docs.cloudhouse.com/guardian/classic/control/integrations/pagerduty-integration/"
---
# PagerDuty integration

Guardian offers several integrations that let you build on the application's core functionality by connecting to external services. One integration available in Guardian is with PagerDuty, an IT incident response service. With this integration, you can connect to your existing PagerDuty account and then configure Guardian actions that automatically log incidents related to your Guardian inventory within PagerDuty.

Applies to: `Guardian Classic`

!!! note

    This topic focuses on setting up the PagerDuty integration. If you've already set up the integration and want to configure PagerDuty actions, see [Action: Trigger a PagerDuty Service](https://docs.cloudhouse.com/guardian/classic/control/events/actions/pagerduty-service/index.md)

## Dependencies

To add a PagerDuty integration, you need:

- A PagerDuty account in which you have one of the following roles: Manager, Administrator, Global Administrator, or Account Owner.
- A PagerDuty integration key.

## Add a PagerDuty integration

Integrating PagerDuty with Guardian establishes a seamless connection to configure Guardian actions that automatically log incidents in PagerDuty.

To add a PagerDuty integration, complete the following steps:

1. In the Guardian web application, navigate to the **Integrations** tab (**Control** > **Integrations**) and click **Add Integration**. The **Add Integration** page is displayed.

    ![Addinteg](https://docs.cloudhouse.com/guardian/classic/assets/images/guardian/control/integrations/addinteg.png)

2. Select **PagerDuty** from the list of available integrations. Here, you are required to complete the following options:

    ![Screenshot of the Guardian Add Integrations page with a highlight box around the PagerDuty button.](https://docs.cloudhouse.com/guardian/classic/assets/images/guardian/control/integrations/pagerduty-integration.png)

    **Name** field
    :   The display name for the integration within Guardian. This name is how you will identify the integration among all others configured in your Guardian instance, so ensure it is descriptive.

**PagerDuty Endpoint** field
:   This integration relies on PagerDuty's events API, which uses the endpoint `https://events.pagerduty.com/generic/2010-04-15/create_event.json`. Enter this endpoint in this field.

**Integration Key** field
:   To connect Guardian to your PagerDuty instance, you need a PagerDuty integration key. This key can be obtained by configuring a new service within PagerDuty. For more information, refer to PagerDuty's [Create a Generic Events API Integration](https://support.pagerduty.com/docs/services-and-integrations#create-a-generic-events-api-integration) article.

3. Once you have set the correct values for each of the options displayed, click **Done** to create the PagerDuty integration.

If successful, a confirmation message is displayed and the PagerDuty integration is added to the **Integrations** tab of your Guardian instance. You can also confirm the integration is successful within PagerDuty. On the PagerDuty **Services** page, you will see an incident triggered by Guardian. This is a handshake message, indicating that the connection has been made.

If unsuccessful, an error message is displayed in Guardian. Use the information displayed in the error message(s) to troubleshoot the values in your **PagerDuty Integration** options.