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. You can set up an outbound iCalendar feed whether you have account-based calendar access or access via shareable calendar link.

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 read-only

An iCalendar feed can only be used to view calendar data, not to modify calendar data. The events that are shown via iCalendar feed are read-only. So the user of the calendar receiving the feed will be able to view the event data, but not modify the events on the feed.

2. iCalendar feeds are one-way

This is a one-way synchronization from Teamup Calendar to another calendar system. The event data from the Teamup calendar is sent via the feed to the other calendar system; there is no data being sent from the calendar to Teamup. (To set up a feed from another calendar into Teamup, see inbound iCalendar feeds.)

3. 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 for both account users and those using shareable calendar links:

  • First, create and view your calendar with a read-only link.
  • Then obtain the iCalendar feed link to share with others:

4. 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.

5. 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.

You can also reset all iCalendar feeds at one time. This is helpful if you wish to tighten up calendar security, after major organizational change, etc. See how to reset all outbound iCalendar feeds.

6. 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.

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

8. 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 April 5, 2022