Get meetings action allows to retrieve properties of the specified online meeting from the calendar in Microsoft Teams.
Example of Get meetings action configuration on the current site
For more information about Action Builder read Action Builder introduction article.
Note 1: In order to use the Get meetings action in Scheduled/Triggered Actions skybow Teams Connector has to be approved by a tenant administrator and site has to be added to Approved sites list before this action can be used. Learn more about skybow M365 Connectors
Note 2: When you deploy the solution to another SharePoint tenant, it requires approval of skybow Teams Connector on the deployment tenant as well.
To configure the action Get meetings additional properties should be specified:
Configuration
Property | Required | Type | Description |
Owner | yes | String | Specify the id, email or principal name of the owner user of the meeting |
Range start | yes | Date or String | Specify the start date and time range parameter to retrieve meetings. String in format 'yyyy-MM-ddTHH:mm:ss'. Note: In case using a custom date, it will take time zone from SharePoint regional settings. Also, you can use function placeholders: UTCToLocalTime or LocalTimeToUTC |
Range end | yes | Date or String | Specify the end date and time range parameter to retrieve meetings. String in format 'yyyy-MM-ddTHH:mm:ss'. Note: In case using a custom date, it will take time zone from SharePoint regional settings. Also, you can use function placeholders: UTCToLocalTime or LocalTimeToUTC |
Filter by | no | String |
Specify additional filter properties to retrieve meetings from specified range. https://learn.microsoft.com/en-us/graph/filter-query-parameter?tabs=http https://learn.microsoft.com/en-us/graph/api/resources/event?view=graph-rest-1.0#properties |
Order by | no | String |
Specify the sort order of the retrieved meetings. https://learn.microsoft.com/en-us/graph/query-parameters?tabs=http#orderby-parameter |
Availability
Modern Forms | List Actions | Scheduled/Triggered Actions |
- | - | ✓ |
Output
Output Parameter | Type | Description |
Meetings | Array of objects | Returns array of objects with retrieved meeting in a range |
Examples
To use this output and set the value open Expression builder as Assignment expression and add this placeholder:
[[@Actions.Get_meetings.Meetings]][0].Subject
This expression will return the Subject property of the first object. To set this value open Expression builder as Assignment expression and add this placeholder:
To determine the available properties of an object in Scheduled or Triggered actions use Send email action to send email to yourself and add to the email body the following expression or use Add/Update item actions and add expression to the Multiple line of text column:
=JSON.stringify([[@Actions.Get_meetings.Meetings]])
Example of meeting object:
[{
"Subject":"TestMeeting",
"MeetingId":"AAMkADE1NTk1ZTU0LTY1NTctNGU4ZC1iODRkLTI4Yzc2ODBhZjVhMgFRAAgI3IwE7ymAAEYAAAAAD8sUFJv2DESN8Yiy0rFUwgcA4T4Kef1zuUmb...",
"SeriesRootId":"AAMkADE1NTk1ZTU0LTY1NTctNGU4ZC1iODRkLTI4Yzc2ODBhZjVhMgBGAAAAAAAPyxQUm-YMRI3xiLLSsVTCBwDhPgp5-XO5SZs04aRsgJUjA...",
"Start":"2024-06-14T22:10:00.000Z",
"End":"2024-06-14T22:30:00.000Z",
"Owner":"admin@M365x32047128.onmicrosoft.com",
"EventUrl":"https://outlook.office365.com/owa/?itemid=AAMkADE1NTk1ZTU0LTY1NTctNGU4ZC1iODRkLTI4Yzc2ODBhZjVhMgFRAAgI3IwE7ymAAEY...",
"JoinUrl":"https://teams.microsoft.com/l/meetup-join/19%3ameeting_Njc4YzBhNzYtMzEzMy00ZTEyLWIwMzYtODI4OGM5MmFhY2Y4%40thread.v...",
"BodyPreview":"Text message",
"Location":{"Name":"Conf Room Adams","LocationType":"Default","Coordinates":null,"Address":null},
"RequiredAttendees":["NestorW@M365x32047128.OnMicrosoft.com"],
"OptionalAttendees":["AlexW@M365x32047128.OnMicrosoft.com"]
}]
Subject | Title of the meeting |
MeetingId | Internal Id of your occurrence meeting that is used for Update/Delete meeting actions |
SeriesRootId | Id of your series meetings that is used for Update/Delete meeting actions |
Start | Start time of the meeting |
End | End time of the meeting |
Owner | Email of the owner of the meeting |
EventUrl | URL of the meeting to the outlook |
JoinUrl | URL of the meeting to joining for |
BodyPreview | The preview of the message associated with the meeting |
Location | The location of the meeting. |
RequiredAttendees | User email of required attendees |
OptionalAttendees | User email of optional attendees |