1. Home
  2. Integration
  3. How to Manage Outbound iCalendar Feeds from Your Teamup Calendar

How to Manage Outbound iCalendar Feeds from Your Teamup Calendar

An iCalendar feed syncs data from one calendar or calendar service to another. You can set up iCalendar feeds to be inbound (coming into your calendar from another calendar) or outbound (going out of your calendar to another calendar). This article discusses how to manage outbound iCalendar feeds from your Teamup calendar to other calendars. For information about inbound iCalendar feeds, see this article.

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.

With an ics feed, you can display Teamup Calendar events in Apple iCal, Google Calendar, Outlook or any other calendar applications that supports iCalendar feeds. 

To set up iCalendar feeds in these other calendar services, see how to subscribe to Teamup iCalendar feeds to view Teamup in other calendar programs.

What you need to know about iCalendar feeds

1. iCalendar feeds are one-way

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

2. Consider security with iCalendar feeds

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.

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. How to disable iCalendar feeds

Enable or disable outbound iCalendar feeds for all users.

If you wish to prevent the use of iCalendar feeds from your Teamp calendar, you can do so globally in the calendar settings.

  • Open the calendar with administrator access.
  • Go to Settings -> General Settings.
  • Check No to disable iCalendar feeds for all calendar users.

4. How to terminate an iCalendar feed

If you need to prevent former collaborators 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.

5. Date range covered in iCalendar feeds

iCalendar feeds include event data from 6 months in the past to 12 months in the future.

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

6. Update frequency of iCalendar feeds

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.

7. Using other devices and calendar apps

How other calendars or devices will allow subscription to an ics format calendar feed may vary greatly and 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.

Updated on July 24, 2020