Schedules in Third-Party Apps

Add PagerDuty schedules to third-party apps like Confluence, Apple Calendar, Google Calendar, Microsoft Outlook, etc.

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

In PagerDuty

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

Copy link address

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.
Select Calendars

Select Calendars

  1. Select Subscribe by URL.
Select Subscribe by URL

Select Subscribe by URL

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

Subscribe to calendar

📘

Schedule Name Length

Atlassian expects the name of your schedule in PagerDuty to be 28 characters or fewer. 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.
Team Calendars widget

Team Calendars widget

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

Calendar Apps

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

📘

Note

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

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

  1. Go to User Icon My Profile User Settings tab.
  2. Under Calendar settings, right click WebCal feed and copy the link (alternatively, you can download the .ics file by clicking on iCalendar file).
Select WebCal feed

Select WebCal feed

  1. Open Google Calendar or iCal — in this example, we will add the schedules to Google calendars.
  2. Under Other calendars, select From URL from the drop-down list.
  3. Paste the URL and click Add calendar.
Paste calendar URL

Paste calendar URL

Export Schedules from My On-Call Shifts

  1. Navigate to People My On-Call Shifts.
  2. Click Export Calendar.
  3. Select WebCal feed or iCalendar file.
Export calendar

Export calendar

Export a Single Schedule

If you do not want to export all your on-call schedules, you can also choose to export schedules individually.

The iCal or WebCal link for a specific schedule can be found by clicking on the specific 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. Go to People Schedules.
  2. Next to a calendar click Export Just My Calendar to launch your calendar application. You will be prompted to subscribe to the calendar URL.
Export just my calendar

Export just my calendar

  1. In this example we're using Apple Calendar — click Subscribe to finish importing your personal schedule.
Paste calendar URL

Paste calendar URL

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.
Select Everyone

Select Everyone

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

Making 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 the PagerDuty web app. Therefore, once an on-call schedule has been exported, you will not need to edit it when you make changes to the schedule in PagerDuty.

📘

Note

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 for more information about deleting a PagerDuty schedule.

Troubleshooting WebCal Exports

If you experience any of the following issues when exporting your PagerDuty schedule WebCal feeds to Google Calendar:

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

These errors are related to syncing and caching issues in Google Calendar when it fetches a calendar feed that was added by URL. There are several threads on this topic in Google Product Forums, however, none reflect a concrete resolution.

If you do experience this issue, please test the following fixes when initially subscribing to the calendar via URL:

  • Add ?nocache to the end of the feed URL.

    • For example, in place of webcal://yoursubdomain.pagerduty.com/private/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/feed/XXXXXXX, use webcal://yoursubdomain.pagerduty.com/private/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/feed/XXXXXXX?nocache.
  • Change webcal:// to http:// or https:// at the beginning of the URL.

    • For 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. Go to User Icon My Profile, select the User Settings tab, then click Regenerate feed URLs.
Select Regenerate feed URLs

Select Regenerate feed URLs

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

Learn more