How to Connect Tellspin to PagerDuty

How the PagerDuty Integration Works

By connecting Tellspin to PagerDuty, you can use your PagerDuty schedules as the source of truth for your on-call rotations. Tellspin will automatically sync the on-call user from a PagerDuty schedule and update a designated Slack user group (e.g., @dev-on-call) with that person.

This allows your team to mention a consistent Slack handle to reach the current on-call engineer, without having to check PagerDuty.

Step 1: Generate a PagerDuty API Key

First, you need to create a read-only API key in PagerDuty for Tellspin to use.

1. Log in to your PagerDuty account.

2. Navigate to Integrations > API Access Keys.

3. Click Create New API Key.

4. Give the key a descriptive name, such as "Tellspin Integration".

5. Ensure the key is not set to be a full-access key. A read-only key is recommended for security.

6. Click Create Key and copy the generated key. You will not be able to see it again.

   

Step 2: Create a New Schedule in Tellspin

1. Go to the Tellspin App Home in Slack and click Create Schedule.
2. Give your schedule a name and choose User Group as the contact method. This will create the Slack handle (e.g., @dev-on-call) that Tellspin will manage.

Step 3: Select 'PagerDuty' as the Source

In the schedule creation modal, under How are participants selected?, choose Sync from PagerDuty.

Step 4: Enter Your API Key and Select a Schedule

1. Paste the PagerDuty API key you generated in Step 1 into the PagerDuty API Key field.
2. Click Save and Fetch Schedules.
3. Tellspin will connect to PagerDuty and populate the PagerDuty Schedule dropdown. Select the on-call schedule you want to sync.

Step 5: Map Users and Save

Tellspin will attempt to automatically map users from PagerDuty to Slack based on their email addresses. Review the User Mapping section to ensure all users are correctly matched. If a user cannot be matched automatically, you can select their Slack account from the dropdown menu.

Once you've confirmed the mapping, click Save at the bottom of the modal.

Your schedule is now active. Tellspin will begin syncing from PagerDuty and will update your Slack user group with the current on-call person.

Having trouble? See our Troubleshooting PagerDuty User Mapping guide.