1. Home
  2. Integration
  3. Managing Outbound iCalendar Feeds from Your Teamup Calendar

Managing Outbound iCalendar Feeds from Your Teamup Calendar

What is a Teamup iCalendar Feed

An iCalendar feed, often also called ics feed, is a calendar format which allows you to share calendar data from one calendar service to another calendar service. It allows you to display Teamup Calendar events in Apple iCal, Google Calendar, Outlook or any other calendar applications that supports iCalendar feeds.  See how to subscribe to Teamup iCalendar feeds to view Teamup in other calendar programs.

The information below is about the outbound iCalendar feeds, i.e. subscribing to Teamup Calendar from other calendars.  For the other way around, please check out our inbound iCalendar feeds that allow users to subscribe to external calendars from Teamup.

Important to know

1. iCalendar feeds are one-way

iCalendar feeds can only be used to view calendar data but not to modify calendar data. This is a one-way synchronization from Teamup Calendar to another calendar system.

2. Security

If your Teamup Calendar contains private or time-critical data, please carefully consider the security implications and update frequency issues described below before enabling the iCalendar feeds for all your users. iCalendar feeds can be enabled or disabled in Settings -> General Settings.

It is important to know that the iCalendar feed URLs contain the secret key of the associated calendar link. When sharing iCalendar feed URLs with your calendar users, please be sure to share feed URLs with the proper permission.

For example, if you open your Teamup Calendar with a link that has administration permission, the associated iCalendar feed URLs will contain the secret key of the administration link. Obviously, these feed URLs should not be shared with users that are not administrators. It is important to obtain the iCalendar feed URLs from a calendar link with the appropriate permission.

Good practice would be to view your calendar with a read only link first. Then obtain the iCalendar feed link to share with others:

3. Terminate an iCalendar feed

If you need to prevent former collaborator from accessing an iCalendar feed, you can either delete the associated calendar link or change the password for the associated calendar link.

If a calendar link is deleted, all iCalendar feed URLs associated with that calendar link will stop working. However, data shared in the past cannot be taken back.

Users of password protected calendars links can subscribe to the feeds the same way as from non-password protected calendar link.  The password is encoded securely into the feed URL. If the password of a calendar link changes, the associated iCalendar feed URLs will stop working.

4. Date range covered

iCalendar feeds include event data between 6 months in the past and 12 months in the future.

If you need to export all event data of your calendar, for example for backup or migration to another tool, the recommended approach is to use the export tool available in the settings of your calendar.

5. Update frequency

Teamup refreshes the feed source immediately after each change. However, the update frequency a user experiences varies depending on the subscribing calendar program:

  • Apple iCal: It is possible to configure the feed update frequency between 5 minutes and once a week.
  • Outlook and Google Calendar: The update frequency is not configurable. In our experience it can take several hours to days to refresh. This is outside the control of Teamup.

You can force an update by removing a feed and re-subscribing. Consider cache busting by appending a parameter such as a timestamp, e.g. ?t=090301 at the end of the feed URL.

6. Other devices and calendar apps

How other calendars or devices will allow subscription to an ics format calendar feed is beyond the control of Teamup.  If you are experiencing problems with subscribing from your device, especially non-iPhone smart phones, please google for answers.  If you find useful tips and would like to share with us, we’d most appreciate it.

Keywords: sync, outlook, google, apple, transfer

Updated on February 25, 2019