Skip to main content

IMPORTANT - Product End of Life Statement - IMPORTANT

Request RE, Survey, and Calendar 1.5 Support Ending December 31, 2020
Contact Kinetic Data Support with Questions
Kinetic Community

Microsoft Exchange Appointment Search


This handler searches the calendar of the configured user to retrieve data about individual Exchange appointments that fall within the parameters provided at run time.


By downloading this file, you acknowledge that you agree to our Terms of Service

This handler requires that you are running at least Kinetic Task 2.0.

Detailed Description

This handler takes in the Recurring Event Master ID and a date range and returns all instance occurrence IDs found within the time frame.  The intended use of this event is to retrieve the ID of an event that is known to exist; therefore an exception is raised if no events are found within the timeframe provided.

The handler takes a starting and ending point which must be in UTC time. The other input is the Appointment ID that was returned when the recurring event was created (for a recurring event, the ID represents the container for ALL occurrences).

The handler will only return the ID of the first matching occurrence within the date range provided. 


Name Description
Start Date The start of the new appointment in UTC with the format 'YYYY-MM-DD'.
End Date The end of the new appointment in UTC with the format 'YYYY-MM-DD'.
Subject A string to search the contents of the subject. Doesn't need to be an exact match, just checks if it contained in the subject.

Sample Configuration

Parameter Example Configuration
Start Date 2016-07-01T05:00:00
End Date 2016-07-07T05:00:00
Subject Client


Name Description
appointments_json A JSON string representing the appointment.  Output includes:  id, subject, location, body, start, end, required attendees, optional attendees


Change Log

Version Date Description
1 2016-07-26

Initial Version