# 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](#confluence) and [calendar apps](#calendar-apps), such as Google Calendar and Apple Calendar.

- [Confluence](#confluence) 
- [Calendar Apps](#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.

![A screenshot of the PagerDuty web app showing how to copy the schedule link address](/images/kb/4866fe3288cff5322107042e0fa8cb485815ffb6eded7467b9c27233346a7cc6-copy_link_address.webp)
*Copy link address*

### In Confluence

#### Subscribe to a PagerDuty Schedule

Before you can [add a PagerDuty on-call schedule to a Confluence page](#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**.

![A screenshot of the Confluence web app showing how to select Calendars](/images/kb/b4a1f56a5f2eec3494c1eea6ef35ab4f21b6a49a406540f1cbd5db84c32bfea8-image5.webp)
*Select Calendars*

2. Select   **Subscribe by URL**.

![A screenshot of the Confluence web app showing where to select Subscribe by URL](/images/kb/3c5f112eed9c47526f72fc822f3380c203612147bd68a51b33f33068cbebaf7a-image11.webp)
*Select Subscribe by URL*

3. In the **Subscribe** dialog window, enter a **Calendar name**, paste the **iCal URL** from [step 2 above](#in-pagerduty), and click **Subscribe**.

![A screenshot of the Confluence web app showing where to enter the iCal URL to subscribe to calendar](/images/kb/1967e46bd29cc6b0f04cacd9576b1836f22f6121e85c0fb43e962ffa7db9ed56-subscribe_to_an_on-call_schedule.webp)
*Subscribe to calendar*

> **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](#subscribe-to-a-pagerduty-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.

![A screenshot of the Confluence web app showing the Team Calendars widget](/images/kb/4e2114f5ac362a4d0261a8d2c285988a8baea23dd72c3c831262d96ca6c0e174-image1.webp)
*Team Calendars widget*

3. In the right panel’s **Calendar** field, search for and select the calendar you [subscribed to above](#subscribe-to-a-pagerduty-schedule).
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-all-schedules)
- [Export a Single Schedule](#export-a-single-schedule)
- [Changes to Schedules](#changes-to-schedules)
- [Troubleshooting WebCal Exports](#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**.

![A screenshot of the PagerDuty web app emphasizing the WebCal feed link](/images/kb/c5a1cde725b218b08f1ec863a9dea9d9a199287837c869e031e30d5750c2d0c6-image3.webp)
*Select WebCal feed*

3. Open [Google Calendar](https://calendar.google.com/calendar/render#main_7) 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**.

![A screenshot of the Google Calendar web app showing where to paste the calendar URL](/images/kb/0e66f84534c6b80e5bfc8d2b108a4962be730feb6b4bb63e18cdb4e08cddd7ff-image9.webp)
*Paste calendar URL*

#### 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**.

![A screenshot of the PagerDuty web app showing a dropdown Export Calendar](/images/kb/2dc9c84634d33648a7fcaa00eb753079ead0dc6301cda3aede7ebdea2b22e4bf-image10.webp)
*Export calendar*

### 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](#export-only-your-on-call-shifts) or the [entire schedule](#export-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.

![A screenshot of the PagerDuty web app showing how to export just my calendar](/images/kb/ee469343fe9ce4c6bfad40572e339720e9426affca680878bfa2c02b76766313-image7.webp)
*Export just my calendar*

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

![A screenshot of Apple Calendar showing the on-call schedule's URL and a prompt to Subscribe](/images/kb/5c9958aed002f596a883594e355d88d2cf61fd9808af2aa538fec672b30518b8-image2.webp)
*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.

![A screenshot of the PagerDuty web app showing where to select Everyone](/images/kb/a946161f18cee58fc6083e5635d4809bc8c2671e3c500734e22c060f32c417e4-schedules-third-party-everyone.webp)
*Select Everyone*

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](https://support.google.com/calendar/answer/37188?hl=en&co=GENIE.Platform%3DDesktop). 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](https://support.microsoft.com/en-us/office/delete-a-calendar-in-outlook-9ba1364c-bdb0-41be-8f66-eaf96698d021) 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**.

![A screenshot of the PagerDuty web app showing how to regenerate calendar feed URLs](/images/kb/e3b20705344a166140a28300556106810f9326a7ffa1aa7c9d1f9ac38b7883fc-image6.webp)
*Select Regenerate feed URLs*

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