Exporting a PagerDuty schedule to a third-party app allows users to review their on-call shifts without logging in to multiple products. Common choices include Confluence and calendar apps, such as Google Calendar and Apple Calendar.

• Confluence
• Calendar Apps

Confluence

In PagerDuty

1. Navigate to People Schedules.
2. To the right of the schedule you would like to export, select Export. In the section iCalendar file, right click Everyone and select Copy Link Address. Keep this link address for later use.

In Confluence

Subscribe to a PagerDuty Schedule

Before you can add a PagerDuty on-call schedule to a Confluence page, you’ll need to subscribe to it.

1. Go to User Icon Personal Space Calendars.

2. Select Subscribe by URL.

3. In the Subscribe dialog window, enter a Calendar name, paste the iCal URL from step 2 above, and click Subscribe.

📘

Schedule Name Length

Atlassian expects the name of your schedule in PagerDuty to be 28 characters or less. If the name of your PagerDuty schedule has 29 or more characters, then you will see the following error in Confluence: Specified calendar does not seem like iCalendar. Note that this refers to the schedule's name and not the iCal URL.

The same error message will appear if one or more of your users in PagerDuty has a name that is 29 or more characters long.

Add a PagerDuty On-Call Schedule to a Confluence Page

After subscribing to a PagerDuty on-call schedule:

1. Select Create from the top navigation bar or press c to create a new page.
2. Give the page a title, type /team calendars, and select the Team Calendars widget.

3. In the right panel’s Calendar field, search for and select the calendar you subscribed to above.
4. Click Publish in the top right corner.

Calendar Apps

You can integrate your on-call schedule with calendar software (e.g., Apple Calendar, Google Calendar, Microsoft Outlook, etc.) using the WebCal or iCal formats.

📘

Historical Data

iCal and WebCal feeds will display historical data over a 1-month period. Up to 6 months of on-call schedules can be exported in the feed.

• Export All Schedules
• Export a Single Schedule
• Changes to Schedules
• Troubleshooting WebCal Exports

Export All Schedules

You can export all of your personal on-call schedules at once on your profile page.

1. In the PagerDuty web app, go to User Icon My Profile and select the User Settings tab.
2. In the section Calendar, right click WebCal feed and copy the link. Alternatively, you can download the .ics file by clicking iCalendar file.

3. Open Google Calendar or preferred calendar application. In this example, we will use Google Calendar.
4. Under Other calendars, select From URL from the drop-down list.
5. Paste the URL and click Add calendar.

Export Schedules from My On-Call Shifts

1. In the PagerDuty web app, navigate to People My On-Call Shifts.
2. Click Export Calendar.
3. Select WebCal feed or iCalendar file.

Export a Single Schedule

You can also export schedules individually.

Find the iCal or WebCal link for a specific schedule by clicking on the schedule and selecting Export. You can export only your on-call shifts or the entire schedule with everyone's shifts. When exporting the calendar feed from the Schedules page, it will export only the selected on-call schedule.

Export Only Your On-Call Shifts

1. In the PagerDuty web app, go to People Schedules.
2. Next to a calendar select Export Just My Calendar to launch your calendar application. You will be prompted to subscribe to the calendar URL.

3. In this example we're using Apple Calendar — click Subscribe to finish importing your personal schedule.

Export the Entire Schedule

1. Go to People Schedules.
2. To the right of your desired schedule, select Export WebCal feed Everyone to launch your calendar application. You will be prompted to subscribe to the calendar URL.

3. Confirm the subscription to complete the import of the entire schedule.

Changes to Schedules

Once an on-call schedule is exported into Google Calendar, Google Calendar will automatically update when you make a change to the on-call schedule in PagerDuty. This means that once an on-call schedule has been exported, you will not need to edit it when you make changes to the schedule in PagerDuty.

📘

Refresh Period

Google Calendar can take up to 24 hours to refresh an imported on-call schedule. This is because Google Calendar caches the data every time it refreshes.

Delete an Imported Schedule

Sometimes when you import the wrong calendar into Google Calendar and attempt to import a different calendar it may not import correctly. Unsubscribing from the wrong calendar in Google Calendar and importing the correct one should resolve this issue.

For more information, please see Google’s documentation Delete or unsubscribe from a calendar. After you’ve removed the incorrect schedule, you can try importing the correct one again.

Outlook users can review Microsoft's documentation Delete a calendar in Outlook for more information about deleting a PagerDuty schedule.

Troubleshooting WebCal Exports

Users may occasionally encounter errors when working with exported WebCal feeds in Google Calendar. For example:

• Google Calendar displays an error could not fetch URL.
• A loading message appears in Google Calendar, but events are not imported.

These errors are typically related to syncing and caching issues in Google Calendar when it fetches a calendar feed that was added by URL. If you do experience this issue, please test the following fixes when initially subscribing to the calendar via URL:

1. Add ?nocache to the end of the feed URL.
   1. Example: In place of webcal://yoursubdomain.pagerduty.com/private/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/feed/XXXXXXX, use webcal://yoursubdomain.pagerduty.com/private/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/feed/XXXXXXX?nocache.
2. Change webcal:// to http:// or https:// at the beginning of the URL.
   1. Example: In place of webcal://yoursubdomain.pagerduty.com/private/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/feed/XXXXXXX, use http://yoursubdomain.pagerduty.com/private/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/feed/XXXXXXX.

Reset Your Personal Calendar Feed URLs

You may wish to reset the URL associated with your personal calendar feed. This action will update all of your on-call schedules. Please note, these URLs are different from the calendar feed URLs associated with an on-call schedule.

1. In the PagerDuty web app, go to User Icon My Profile.
2. Select the tab User Settings and click Regenerate feed URLs.

3. Use the newly generated WebCal or iCal links to update your calendar application.