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
- Go to People On-Call Schedules.
- 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](https://files.readme.io/374d0eb-copy_link_address.png)
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.
- Go to User Icon Personal Space Calendars.
![image5.png Select Calendars](https://files.readme.io/a3d67f1-image5.png)
Select Calendars
- Select Subscribe by URL.
![image11.png Select Subscribe by URL](https://files.readme.io/0617a10-image11.png)
Select Subscribe by URL
- In the Subscribe dialog window, enter a Calendar name, paste the iCal URL from step 2 above, and click Subscribe.
![image8.png Subscribe to calendar](https://files.readme.io/8c9bef2-subscribe_to_an_on-call_schedule.png)
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:
- Select Create from the top navigation bar or press
c
to create a new page. - Give the page a title, type
/team calendars
, and select the Team Calendars widget.
![image1.png Team Calendars widget](https://files.readme.io/ce11d6e-image1.png)
Team Calendars widget
- In the right panel’s Calendar field, search for and select the calendar you subscribed to above.
- 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
- Export a Single Schedule
- Making 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.
- Go to User Icon My Profile User Settings tab.
- Under Calendar settings, right click WebCal feed and copy the link (alternatively, you can download the .ics file by clicking on iCalendar file).
![image3.png Select WebCal feed](https://files.readme.io/1d5f9a3-image3.png)
Select WebCal feed
- Open Google Calendar or iCal — in this example, we will add the schedules to Google calendars.
- Under Other calendars, select From URL from the drop-down list.
- Paste the URL and click Add calendar.
![image9.png Paste calendar URL](https://files.readme.io/270d253-image9.png)
Paste calendar URL
Export Schedules from My On-Call Shifts
- Navigate to People My On-Call Shifts.
- Click Export Calendar.
- Select WebCal feed or iCalendar file.
![image10.png Export calendar](https://files.readme.io/30bb434-image10.png)
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 On-Call Schedules page, it will export only the selected on-call schedule.
Export Only Your On-Call Shifts
- Go to People Schedules.
- Next to a calendar click Export Just My Calendar to launch your calendar application. You will be prompted to subscribe to the calendar URL.
![image7.png Export just my calendar](https://files.readme.io/8a80d40-image7.png)
Export just my calendar
- In this example we're using Apple Calendar — click Subscribe to finish importing your personal schedule.
![image2.png Paste calendar URL](https://files.readme.io/52b1b17-image2.png)
Paste calendar URL
Export the Entire Schedule
- Go to People Schedules.
- 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.
![schedules-third-party-everyone.png Select Everyone](https://files.readme.io/d3223a3-schedules-third-party-everyone.png)
Select Everyone
- 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
, usewebcal://yoursubdomain.pagerduty.com/private/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/feed/XXXXXXX?nocache
.
- For example, in place of
-
Change
webcal://
tohttp://
orhttps://
at the beginning of the URL.- For example, in place of
webcal://yoursubdomain.pagerduty.com/private/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/feed/XXXXXXX
, usehttp://yoursubdomain.pagerduty.com/private/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/feed/XXXXXXX
.
- For example, in place of
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.
- Go to User Icon My Profile, select the User Settings tab, then click Regenerate feed URLs.
![image6.png Select Regenerate feed URLs](https://files.readme.io/05c0d7e-image6.png)
Select Regenerate feed URLs
- Use the newly generated WebCal or iCal links to update your calendar application.
Updated 3 months ago