Find Meeting Times

Suggests meeting times.

This activity suggests a meeting time and location-based or organizer and attendee availability and the specific time in which the meeting should occur etc using the Microsoft Graph Find meeting times API.

Input

• Connection Id: GraphServiceClient Variable Required Specifies the office 365 connection id.

• Account: String Argument Specifies an email address with which to interact. This property can include any shared mailbox to which the current user has access rights. If the property field is left empty, the current user's account is used. This is an optional property.

• Attendees:String Argument Required Specifies the email addresses of the attendees.Each of the mail addresses should be separated by a semicolon.

• Interval Start: String Argument Specifies the begining of the time period to search for the openings in DateTime format. The input should be given in double-quotes.

• Interval End: String Argument Specifies the ending of the time period to search for the openings in DateTime format. The input should be given in double-quotes.

• Meeting Duration: Integer Argument Specifies the duration of the meeting in minutes. By default the value is 30.

• Time Zone: String Argument Specifies the time zone in which the Start Time and End Time are to be interpreted. The default value is the local system time zone.

Options

• Locations: String Argument Specifies the room or location names to search.Each of the room or location names should be separated by a semicolon. If the specified locations or meeting rooms are not available, the activity does not return any suggestions.

• Organizer Required: If set to true, then the user is a required attendee for the given meeting.

• Policy: Specifies the attendee restrictions to be followed while searching for the available meeting times. The available options are:

  • Unknown - Behaves the same as work. Change any existing code to use work, personal or unrestricted as appropriate.

  • Work - Suggestions are within the user's work hours which are defined in the user’s calendar configuration and can be customized by the user or administrator. The default work hours are Monday to Friday, 8 am to 5 pm in the time zone set for the mailbox. This is the default value if no activity Domain is specified.

  • Personal - Suggestions are within the user's work hours, and Saturday and Sunday. The default is Monday to Sunday, 8 am to 5 pm, in the time zone setting for the mailbox.

  • Unrestricted - Suggestions can be from all hours of a day, all days of a week.

  By default the value is Unrestricted.

Output

• Available Timeslots: MeetingTimeSuggestion Variable Specifies an array of meeting times, attendees available.

  ---

• Empty Suggestion Reason: String Variable Specifies a reason for not returning any meeting suggestion. The available values may include attendeesUnavailable, attendeesUnavailableOrUnknown, locationsUnavailable, organizerUnavailable, or unknown.