Skip to main content

ICS Feed Subscription

Subscribe to any hosted calendar's ICS feed for read-only access in any calendar app. The feed URL serves standard .ics content that any calendar application can import or subscribe to.

Feed URL​

Every hosted calendar has a unique feed URL based on its feedToken:

https://www.calendarpipe.com/feed/{feedToken}

The feedToken is returned when you create a hosted calendar and is also visible via GET /api/v1/hosted-calendars.

webcal:// Shortcut​

tip

Use the webcal:// scheme to auto-open the URL in your default calendar app on macOS and iOS:

webcal://www.calendarpipe.com/feed/{feedToken}

Clicking a webcal:// link in a browser opens the calendar subscription dialog directly.

Apple Calendar​

  1. Open Apple Calendar.
  2. Go to File > New Calendar Subscription.
  3. Paste the feed URL (either https:// or webcal://) and click Subscribe.
  4. Configure the refresh interval and click OK.

Screenshot: Apple Calendar subscription dialog

Google Calendar​

  1. Open Google Calendar in a browser.
  2. In the left sidebar, click Other calendars (the + icon).
  3. Select From URL.
  4. Paste the https:// feed URL and click Add Calendar.
info

Google Calendar does not support the webcal:// scheme in this flow — use the https:// URL instead.

Outlook​

  1. Open Outlook (desktop or web).
  2. Go to Add calendar > From internet (or Subscribe from web).
  3. Paste the feed URL and follow the prompts.

Caching and Refresh​

CalendarPipe serves ICS feeds with a 1-hour cache TTL. Calendar apps typically poll for updates every 15 to 60 minutes depending on the app and settings.

As a result, newly created or updated events may take up to 1 hour to appear in subscribing apps.

Limitations​

LimitationDetails
Read-onlyICS feeds are read-only. Changes made in the subscribing app will not sync back to CalendarPipe.
Caching delayNew events may take up to 1 hour to appear due to the 1-hour cache TTL.
No real-time pushThe subscribing app polls at its own interval — there is no push notification mechanism.

For two-way sync with real-time updates, use CalDAV Setup instead.

info

The feed URL changes if you regenerate the calendar's feed token. All subscribers will need to re-add the feed with the new URL.

Next Steps​