Read Available Time Slots

Find available time slots in your Google Calendar account.

Input

Field Definition Type Required
Hourly Window
Day Date in the format YYYY-MM-DD. String TRUE
Start Time Date and time at which you want the event to start in the format HH:MM:SSZ. Date & Time TRUE
End Time Date and time at which you want the event to end in the format HH:MM:SSZ. Date & Time TRUE
Time Zone Time zone in the format:
  • UTC+-HH
  • GMT+-HH
  • CEST+-HH (Central European Summer Time)
  • EEST+-HH (Eastern European Summer Time)
  • Territory/Town
Date & Time TRUE
Event Duration
Duration Duration of the event in minutes; value must be 1 or higher. Number FALSE
Calendar
Calendar ID Calendar identifier. String TRUE

Output

Field Definition Type
Fields
Number of Available Slots

The number of available slots that are available on the user's calendar for that time frame. Given the Duration input field value, this is the number of events with the given duration that can fit in the user's schedule. Examples:

  • If there is a gap of 45 minutes on a calendar, and the duration input is 20 minutes, then the Number of Available Slots returned will be 2.
  • If there are only four 20 minute slots available on a calendar, but the duration input is 30 minutes, then the Number of Available Slots returned will be 0 (even though there is a total of 80 minutes available).
Number
Total Minutes Available Total number of minutes available on the user's calendar. Number
List of Busy Times A list of busy time objects. Each object returned in this list is a window of time from start to end that the user is busy/has events scheduled. List of Objects
List of Available Times A list of available time objects. Each object returned in this list is a window of time from start to end that the user is available to schedule an event of duration that is less than or equal to the user's input duration. List of Objects

Related topics

Google Calendar connector

About the elements of Okta Workflows

G Suite API documentation