Flowdock Integration Guide

This integration requires use of our v1 REST API which is currently in a decommissioning period, please contact support to gain access to a v1 REST API key to configure this integration.

For more information about the v1 REST API deprecation, take a look at our FAQ here: https://v2.developer.pagerduty.com/v2/docs/v1-rest-api-decommissioning-faq

We are working with partners to upgrade integrations to use our v2 REST API.

Flowdock is a team collaboration app for desktop, mobile and web. You can receive real-time alerts into your “flow” by integrating PagerDuty and Flowdock.

Note: Flowdock will automatically configure Webhooks for your Services via the PagerDuty API. This means that you must be an Admin or the Account Owner to complete the Flowdock integration, as a standard User or Limited User account does not have access to add an API key in PagerDuty.

In PagerDuty

  1. From the Configuration menu, select API Access.
    apiaccess-0
  2. On your API Access page, click the +Create New API Key button.apiaccess-1
  3. In the dialog that pops up, you’ll be prompted to enter a Description for your key, and choose an API version. You will also have the option to create the key as Read-only; leaving this box unchecked will create a full access key._int3__API_Keys_-_PagerDuty A note about versioning: API v2.0 is designed to make it easier for new integrations to communicate with PagerDuty. Most existing PagerDuty integrations will require an API v1.0 key. If you have questions on which API version to use, please contact support@pagerduty.com
  4. Once you have filled in your options, click Create Key.
  5. Once you click Create Key, you will see a dialog displaying your key and confirming the options you filled in on the previous step. Make sure to copy this key into any application that needs it now, as you will not have access to the key after this step. If you lose a key that you created previously and need access to it again, you should remove the key and create a new one. Click Close once you have successfully copied your key.api__2_
  6. Once created, you will see your key appear in the list of keys on the API Access page, with versioning noted.api__3_

In Flowdock

  1. Click the gear menu next to the flow you want PagerDuty notifications to be posted in, then click Inbox Settings.
    Flowdock Inbox Settings
  2. In the Inbox Sources tab, scroll down until you see PagerDuty, then click Add new +.
    Flowdock Sources Add PD
  3. Enter your PagerDuty subdomain and paste in the API key you created earlier, then click Continue.
    Enter Sub and Key in Flowdock
  4. Select the PagerDuty Service(s) that you want to receive notifications for in your flow and click Connect.Select PD Services in Flowdock
  5. That’s it. Your flow should now be getting alert notifications from PagerDuty in Flowdock!
    Flow Inbox

Now when you go to your chosen Service in PagerDuty you’ll see an extension webhook for Flowdock on the Integrations tab. Note that changing the Endpoint URL or deleting this extension will break your integration, so be careful!

DEMO_-_PagerDuty