Exporting On-Call Schedules to a Calendar App

Follow

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

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 My Profile in the drop-down menu in the top right hand corner of the screen and select the 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).

                

  3. Open Google Calendar or iCal. (In this example, we will add the schedules to Google calendars.)

  4. Under Other Calendars, select Add by URL from the drop-down list.

  5. Paste the URL and click Add 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 (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

  1. Go to the Configuration menu and select 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.

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

sing2.png

Export the entire schedule (everyone's shifts)

  1. Go to the Configuration menu and select Schedules.

  2. In the On-Call Schedules Tab, select Export → Everyone to launch your calendar application. You will be prompted to subscribe to the calendar URL.

  3. Click Subscribe 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 web application. 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 the on-call schedule when modified as Google Calendar caches the data every time it refreshes.

Troubleshooting webcal exports

Export errors

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 issues are due to a Google Calendar issue with syncing and caching when fetching a calendar feed after adding by URL. There are several threads on this topic in Google Product Forums, however, none of these 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:

    webcal://yoursubdomain.pagerduty.com/private/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/feed/XXXXXXX

    turns into

    webcal://yoursubdomain.pagerduty.com/private/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/feed/XXXXXXX?nocache

  • Change webcal:// to http:// or https:// at the beginning of the URL. For example:

    http://yoursubdomain.pagerduty.com/private/xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx/feed/XXXXXXX

Reset Your Personal Calendar Feed URLs

If you would like to reset the calendar feed URLs, please follow these instructions.  Please note, these URLs are different than the calendar feed URLs associated with an on-call schedule. This will update all on-call schedules.

  1. Login to your PagerDuty account.

  2. Go to My Profile, select the User Settings tab, then click Regenerate feed URLs.

  3. Use the links for the WebCal or iCalendar feed to update your calendar application.

Delete an imported schedule

Sometimes when you export the wrong calendar to Google Calendar and attempt to export a different calendar it does not work. Unsubscribing to the wrong calendar in Google Calendar before exporting the new calendar should resolve this issue.

To unsubscribe from a PagerDuty calendar:

  1. In Google Calendar, go to the Settings page.

  2. Go to the Calendars tab, then click Unsubscribe by the PagerDuty calendar. You may need to scroll to see the calendar.

  3. Import your PagerDuty calendar again.

Have more questions? Submit a request

Comments

  • Avatar
    Danny Patel

    Very direct and easy to follow instructions.

    Thanks

  • Avatar
    Tong Sun

    I created a override in pagerduty schedule, but this change does not synced to my google calendar. Is that a bug or what should I do? 

  • Avatar
    Alexis Chu

    Hi Tong, 

    With Google Calendar syncs, it may take up to 24 hours for Google Calendar to recognize the update to the on-call schedule in PagerDuty.

    If you do not see the change in your Google Calendar after 24 hours, then I would recommend contacting support@pagerduty.com so we can troubleshoot your case.

    Alexis

  • Avatar
    Tong Sun

    Thank you, Alexis. Yes, it is get updated about 12 hours later. 

  • Avatar
    Jeremiah Jordan

    Is there a way to get the exported ical to have the time slots not be marked "busy". When I add my on-call schedule to my calendar it blocks off all the days I am on call as being "busy"

  • Avatar
    Alexis Chu

    Hi Jeremiah,

    Your imported on-call schedule will appear as "busy" in your calendar. We'll share your feedback with product as a feature request to change this display. Let us know if you have questions at support@pagerduty.com.

    Alexis

  • Avatar
    Charles Sauls

    Do I have to do something special to get the calendar feed into Outlook 2013? A window that says "Connecting to web server" appears, and then disappears, and the feed isn't appearing. It used to work when I had Outlook 2010, but my hard drive was just replaced and it came with Office 365.

    (I Google'd extensively about this before I asked this question, but haven't found anything relevant.)

    Thank you!

  • Avatar
    Alexis Chu

    Hi Charles,

    Please email support@pagerduty.com about this and we'll investigate this further for you.

    Alexis

  • Avatar
    Pedro Brentan

    How can I add calendar notification to my schedules automatically? It could add the email as participant of the event.....

  • Avatar
    Max Shrieve-Don

    Hi Pedro,

    You can probably get some calendar notifications set up in your calendar app (Google Calendar, Outlook, etc.), but you might also want to consider setting up some on-call handoff notifications in your PagerDuty user profile, which will allow you to be notified of your upcoming on-calls via SMS, email or push notification.

    You can read a little bit more about this in this Knowledge Base article: https://support.pagerduty.com/hc/en-us/articles/202830080