Calendar Feed (iCal)

App · 5 actions

Read any calendar shared as an iCal link, from Google Calendar, Outlook, Apple Calendar or a school, team or booking calendar: list events, get the next one, check if you're busy. Start a workflow when an event is added or about to start.

Actions

ActionWhat it does
Check if busyFind out whether anything on the calendar overlaps a span of time, such as before booking a meeting.
Get calendar detailsGet a calendar's name, description, time zone and how many events it holds.
Get events on a dayGet every event on one day, such as today, in a time zone.
Get next eventGet the event happening now or starting next, within a year.
List eventsList a calendar's events between two times, earliest first, with repeating events expanded.

Check if busy

Find out whether anything on the calendar overlaps a span of time, such as before booking a meeting. Events marked as free don't count.

Inputs

Calendar linkcalendar_urltextRequired
The calendar's iCal link, ending in .ics or starting with webcal://. A secret address works like a password: anyone with it can read the calendar.
Fromstartdate and time
The start of the span. Defaults to now.
Untilenddate and time
The end of the span. Defaults to a minute after 'From'.
Count all-day eventsinclude_all_daytrue/false
Count all-day events as busy too. Off by default, as calendar apps do.Default: false.

Outputs

busytrue/false
True if anything overlaps the span
countnumber
How many events overlap it
eventslist
The events, earliest first
Example output
{
  "busy": true,
  "count": 1,
  "events": [
    {
      "all_day": false,
      "categories": [],
      "description": "Daily check-in",
      "end": "2026-10-29T09:45:00-04:00",
      "end_utc": "2026-10-29T13:45:00Z",
      "location": "Room 4",
      "organizer": "Sam Lee",
      "recurring": true,
      "start": "2026-10-29T09:30:00-04:00",
      "start_utc": "2026-10-29T13:30:00Z",
      "status": "confirmed",
      "time_zone": "America/New_York",
      "title": "Team standup",
      "uid": "7kukuqrfedlm2f9t0vr3nh@google.com",
      "url": ""
    }
  ]
}

Get calendar details

Get a calendar's name, description, time zone and how many events it holds.

Inputs

Calendar linkcalendar_urltextRequired
The calendar's iCal link, ending in .ics or starting with webcal://. A secret address works like a password: anyone with it can read the calendar.

Outputs

descriptiontext
Its description
event_countnumber
How many events it holds, counting a repeating event once
nametext
The calendar's name
repeating_event_countnumber
How many of them repeat
time_zonetext
Its time zone
Example output
{
  "description": "Team meetings and time off",
  "event_count": 42,
  "name": "Team",
  "repeating_event_count": 3,
  "time_zone": "America/New_York"
}

Get events on a day

Get every event on one day, such as today, in a time zone.

Inputs

Calendar linkcalendar_urltextRequired
The calendar's iCal link, ending in .ics or starting with webcal://. A secret address works like a password: anyone with it can read the calendar.
Daydaydate
The day. Defaults to today.
Time zonetime_zonetext
The time zone the day is in, such as America/New_York. Defaults to the calendar's own.

Outputs

calendar_nametext
The calendar's name
countnumber
How many events
daytext
The day (YYYY-MM-DD)
eventslist
The events, earliest first
time_zonetext
The time zone the day was read in
Example output
{
  "calendar_name": "Team",
  "count": 1,
  "day": "2026-10-29",
  "events": [
    {
      "all_day": false,
      "categories": [],
      "description": "Daily check-in",
      "end": "2026-10-29T09:45:00-04:00",
      "end_utc": "2026-10-29T13:45:00Z",
      "location": "Room 4",
      "organizer": "Sam Lee",
      "recurring": true,
      "start": "2026-10-29T09:30:00-04:00",
      "start_utc": "2026-10-29T13:30:00Z",
      "status": "confirmed",
      "time_zone": "America/New_York",
      "title": "Team standup",
      "uid": "7kukuqrfedlm2f9t0vr3nh@google.com",
      "url": ""
    }
  ],
  "time_zone": "America/New_York"
}

Get next event

Get the event happening now or starting next, within a year.

Inputs

Calendar linkcalendar_urltextRequired
The calendar's iCal link, ending in .ics or starting with webcal://. A secret address works like a password: anyone with it can read the calendar.
Containingsearchtext
Only an event whose title, description or location contain these words.

Outputs

all_daytrue/false
True for an all-day event
calendar_nametext
The calendar's name
categorieslist
Its categories, if any
descriptiontext
Its description
endtext
When it ends: for an all-day event, the day after its last day
end_utctext
When it ends, in UTC (ISO 8601)
foundtrue/false
False if no event is coming up
locationtext
Where it is
organizertext
Who organised it, if the calendar says
recurringtrue/false
True if it is one occurrence of a repeating event
starttext
When it starts: a date for an all-day event, otherwise a date and time with its UTC offset
start_utctext
When it starts, in UTC (ISO 8601)
statustext
confirmed or tentative
time_zonetext
The time zone its times are in
titletext
The event's title
uidtext
The event's ID in the calendar; every occurrence of a repeating event shares it
urltext
A link the event carries, if any
Example output
{
  "all_day": false,
  "calendar_name": "Team",
  "categories": [],
  "description": "Daily check-in",
  "end": "2026-10-29T09:45:00-04:00",
  "end_utc": "2026-10-29T13:45:00Z",
  "found": true,
  "location": "Room 4",
  "organizer": "Sam Lee",
  "recurring": true,
  "start": "2026-10-29T09:30:00-04:00",
  "start_utc": "2026-10-29T13:30:00Z",
  "status": "confirmed",
  "time_zone": "America/New_York",
  "title": "Team standup",
  "uid": "7kukuqrfedlm2f9t0vr3nh@google.com",
  "url": ""
}

List events

List a calendar's events between two times, earliest first, with repeating events expanded.

Inputs

Calendar linkcalendar_urltextRequired
The calendar's iCal link, ending in .ics or starting with webcal://. A secret address works like a password: anyone with it can read the calendar.
Fromstartdate and time
The earliest time to include. Defaults to now.
Untilenddate and time
The latest time to include. Defaults to 30 days after 'From'.
Containingsearchtext
Only events whose title, description or location contain these words.
How manylimitnumber
The most events to return. Defaults to 25.From 1 to 500.

Outputs

calendar_nametext
The calendar's name
countnumber
How many events
eventslist
The events, earliest first
Example output
{
  "calendar_name": "Team",
  "count": 1,
  "events": [
    {
      "all_day": false,
      "categories": [],
      "description": "Daily check-in",
      "end": "2026-10-29T09:45:00-04:00",
      "end_utc": "2026-10-29T13:45:00Z",
      "location": "Room 4",
      "organizer": "Sam Lee",
      "recurring": true,
      "start": "2026-10-29T09:30:00-04:00",
      "start_utc": "2026-10-29T13:30:00Z",
      "status": "confirmed",
      "time_zone": "America/New_York",
      "title": "Team standup",
      "uid": "7kukuqrfedlm2f9t0vr3nh@google.com",
      "url": ""
    }
  ]
}

On this page