Having all of your Events in the Platform is great! But what if you could also add them to iCal, Outlook, or a Google Calendar? That way, you could see all your events in one place and make them available to people who aren't in the Platform as often. Well, you can do that -- with an ICS Event Calendar Feed!

All you need is a feed URL. This URL supports a query string to filter the results that you see in your external calendar. See the information below to determine how you want to filter it for your needs. Note: Regardless of the options used, canceled Events are not returned.

Once you have your feed URL, you can add it to your calendar application. Consult your application's help files for information on how to do this. If you use Google Calendar, see Add Events to Google Calendar.

Filtering Events to Display on Your Calendar

A query string contains parameters and values separated by an equal sign (=). The first parameter starts with a question mark (?) and additional parameters are prefixed with an ampersand (&). See the following example which shows Featured Events for a single Congregation:

https://{feed-url}/EventsICS?GetFeaturedEventsOnly=true&CongregationID=1

startDate 

Will select the TOP 1000 Events starting greater than or equal to this datetime up to 12 months. If not specified, the value used is 1 month in the past (today - 1 month).

https://{feed-url}/EventsICS?startDate=12%2F31%2F2020

endDate 

Will select the TOP 1000 Events ending less than this datetime. When not specified, the value is 12 months in the future (today + 12 months). Note: endDate must be used in conjunction with startDate. 

https://{feed-url}/EventsICS?startDate=12-31-2020&endDate=1-31-2021

Notes Regarding Date Parameter Options

• If dates are not specified, the results are limited to 1 month in the past (today - 1 month) to 12 months in the future (today + 12 months).
• The following are valid date formats:
  • m/d/yyyy
  • mm/dd/yyyy (leading zeros)
  • m-d-yyyy
  • mm-dd-yyyy (leading zeros)
• The ICS spec has two types of dates: UTC or "floating time." We're using "floating time," which means the date parameters do not contain any time zone information. That is determined at the website level.

GetFeaturedEventsOnly 

When true, only events with the Featured On Calendar bit field will be returned. (Default: false)

GetRegistrationEventsOnly 

When true, only events with active registrations will be returned. (Default: false)

https://{feed-url}/EventsICS?GetRegistrationEventsOnly=true

MinistryID 

When anything but null, only events for the specified MinistryID will be returned.

https://{feed-url}/EventsICS?MinistryID=107

CongregationID 

When anything but null, only events for the specified CongregationID will be returned.

https://{feed-url}/EventsICS?CongregationID=10

ProgramID

When anything but null, only events for the specified ProgramID will be returned.

https://{feed-url}/EventsICS?ProgramID=36

Room ID

When anything but null, only events for the specified RoomID will be returned.

https://{feed-url}/EventsICS?RoomID=276

Location ID

When anything but null, only events for the specified LocationID will be returned.

https://{feed-url}/EventsICS?LocationID=48

VisibilityLevel

A single or comma-separated list of Visibility Level ID's (1-5) (Default: 4)

Note that if you use anything other than 4, you will likely have to set OnlyApprovedEvents=false

https://{feed-url}/EventsICS?VisibilityLevel=2&OnlyApprovedEvents=false

OnlyApprovedEvents

When true (default), only return events where the _Approved and _Web_Approved bit fields are true. When false, ignore both fields.

https://{feed-url}/EventsICS?VisibilityLevel=2&OnlyApprovedEvents=false

ShowExtendedData

Show extended event information in details (Rooms, Servicing, Resource, Links, etc. )(Default: false)

https://{feed-url}/EventsICS?ShowExtendedData=true

EventID

Show a specific event based on the EventID.

https://{feed-url}EventsICS?EventID=[EventID]