Creating a Generic API Integration


There are more than 150 different monitoring systems, chat services, support tools and other utilities that integrate with PagerDuty out of the box, but even with all of these options, you're limited to using just these products and services with PagerDuty. With our easy-to-use Events API, you can create an API integration for just about anything, so as long as your system can make outbound HTTP calls.

To add a generic API integration:

  1. Go to the Configuration menu and select Services.

  2. If you are creating a new service for your integration, click Add New Service.

    If you are adding your integration to an existing service, click the name of the service you want to add the integration to, then go to the Integrations tab and click New Integration.

  3. Select Use our API Directly from the Integration Type menu and and enter an Integration Name

    If you are creating a new service for your integration, in General Settings, enter a Name for your new service. Then, in incident Settings, specify the Escalation Policy, Notification Urgency, and Incident Behavior for your new service.

  4. Click Add Service or Add Integration and the Integration Key will be generated. You'll find this key on the Integrations tab. The Integration Key is a unique service identifier used by the API to trigger, acknowledge, and resolve incidents for the service via the API. Use this key within your monitoring tool to send notifications to PagerDuty and create incidents within your service.

Once you have added a service, you can optionally add additional integrations. See How do I add multiple Integrations to a service? for more information.

Have more questions? Submit a request