Microsoft Teams

Reference

Microsoft Teams enables you to get all your content, tools and conversations in the Team workspace with Microsoft 365.

This connector is available in the following products and regions:

Service	Class	Regions
Logic Apps	Standard	All Logic Apps regions except the following: - Azure China regions
Power Automate	Standard	All Power Automate regions except the following: - China Cloud operated by 21Vianet
Power Apps	Standard	All Power Apps regions except the following: - China Cloud operated by 21Vianet

Contact
Name	Microsoft
URL	Microsoft LogicApps Support Microsoft Power Automate Support Microsoft Power Apps Support

Connector Metadata
Publisher	Microsoft
Website	https://products.office.com/microsoft-teams/group-chat-software

Known issues and limitations with actions

Short description	Operations	Long description
Message size limit	Post adaptive card and wait for a response Post adaptive card in a chat or channel Post message in a chat or channel Reply with a message in a channel Reply with adaptive card in a channel Update an adaptive card in a chat or channel	When an action posts a message, the message size limit is approximately 28 KB. This limit includes all HTML elements such as text, images, links, tables, mentions and so on. If the message size exceeds 28 KB, the action fails with the error "Request Entity too large".
Set guest users as team owners	Add a member to a team	When you add a member to a team, you can set guest users as team owners.
Requires an Exchange Online Mailbox	Create a Teams meeting	When you create a Teams meeting and want to select a time zone, this action requires an Exchange online Mailbox.
Maximum users per chat	Create a chat	When you create a chat, this action can handle a maximum of 20 users per chat, but doesn't have support for guest users.
Unsupported in Microsoft Cloud for Sovereignty	Post adaptive card in a chat or channel Post message in a chat or channel Reply with a message in a channel Reply with adaptive card in a channel Update an adaptive card in a chat or channel	These actions are not supported in some sovereign clouds namely GCC-H and DoD. The actions are support in GCC Moderate.
Require the Power Automate app	Post adaptive card and wait for a response Post adaptive card in a chat or channel Post message in a chat or channel Reply with a message in a channel Reply with adaptive card in a channel Update an adaptive card in a chat or channel	These actions require Power Automate app availability and setting to the app to the "allow" state in the Teams admin center.

Known issues and limitations with triggers

Short description	Operations	Long description
Supports only user per flow	When a new chat message is added	When a new is posted in any chat where you're a participant in Teams, the trigger can support only one user per flow.
Supports only single words	When keywords are mentioned	The trigger won't fire for phrases that are longer than one word.
Fires for all message-related data	When keywords are mentioned	This data includes the message sender and the text that includes the time when the message was sent.
Fires only for root messages added to channel	When a new channel message is added	When a new message is posted to a channel in Teams, the trigger doesn't fire for replies to an existing channel message.
Works only in default environment	For a selected message From the compose box (V2) When someone responds to an adaptive card	These triggers work only in a default environment.
Doesn't work for guest users	When someone responds to an adaptive card	This trigger doesn't work for guest users in a Team.
Has a 3-minute polling interval	When a new channel message is added When I am mentioned in a channel message	These triggers use a 3-minute polling interval.
Has a 15-minute polling interval	When a new team member is added When a new team member is removed	These triggers use a 15-minute polling interval due to a limitation in the underlying API. This could cause the trigger to fire multiple times for the same event.
Doesn't work on unified groups with hidden members	When a new team member is added When a new team member is removed	These triggers doen't work on unified groups that have hidden members.
Requires Power Automate Actions app	For a selected message	In Power Automate, this trigger requires that the Power Automate Actions app (App ID: 00001016-de05-492e-9106-4828fc8a8687) must be unblocked. Use an admin account to check that the app is enabled in the Teams admin center.
Unsupported in Microsoft Cloud for Sovereignty	For a selected message From the compose box	These triggers are not supported in sovereign clouds such as GCC, GCCH, and DoD.

General known issues and limitations

To use the Teams conector, you must have enabled one of these subscriptions.
Posting a message or adaptive card to a private channel currently isn't supported.
Posting message or card using Power Virtual Agents requires the recipient to have the bot installed in Microsoft Teams. For more information, see Send proactive messages to users in Microsoft Teams.
A single message can @mention only up to 20 users and 20 tags.

Creating a connection

The connector supports the following authentication types:


Microsoft Teams Credentials (Teams GCC High)	Log in with Microsoft Teams Credentials (Teams GCC High).	Azure Government only	Not shareable
Microsoft Teams Credentials (Teams Public/Teams GCC)	Log in with Microsoft Teams Credentials (Teams Public/Teams GCC).	Azure Government only	Not shareable
Default	Log in with your credentials.	All regions except Azure Government	Not shareable

Microsoft Teams Credentials (Teams GCC High)

Auth ID: oauthGccHigh

Applicable: Azure Government only

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Microsoft Teams Credentials (Teams Public/Teams GCC)

Auth ID: oauthPublic

Applicable: Azure Government only

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Default

Applicable: All regions except Azure Government

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	60 seconds
Frequency of trigger polls	1	900 seconds
Non-Get requests per connection	300	3600 seconds

Actions

Add a member to a tag	Adds a user to a tag
Add a member to a team	Adds a member to a Microsoft Team
Create a channel	Create a new channel within a specified team
Create a chat	Creates a one on one or group chat
Create a tag for a team	Creates a tag in a team
Create a team	Creates a new Microsoft Team
Create a Teams meeting	Create a meeting with a link at the bottom of the invite to join the meeting online on Microsoft Teams.
Delete a member from a tag	Deletes a member from a tag
Delete a tag	Deletes a tag from a team
Get a team	Gets a Microsoft Team's details
Get an @mention token for a tag	Creates a token that can be inserted into a message or adaptive card sent as a user in a channel to @mention a tag.
Get an @mention token for a user	Creates a token that can be inserted into a message or adaptive card to @mention a user.
Get message details	Gets details of a message in a chat or a channel
Get messages	This operation is used to get messages from a channel in a specific team
List all tags for a team	Lists the team's tags
List channels	Lists all the channels for a specific team
List chats	Lists recent chats you are a part of
List members	List members of a group chat
List teams	Lists all the Microsoft Teams you are a member of
List the members of a tag	Lists the members of a tag
Post a choice of options as the Flow bot to a user	Send a set of options to a Microsoft Team's user, that they must respond to before the flow will continue. This action will pause the flow until the user response to the options
Post a feed notification	Posts a notification to a user's activity feed linking to a chat or team.
Post a message (V2) [DEPRECATED]	This operation is used to post a message to a channel in a specific Team.
Post a message (V3) [DEPRECATED]	This operation is used to post a message to a channel in a specific Team.
Post a message [DEPRECATED]	This operation is used to post a message to a channel in a specific Team.
Post a message as the Flow bot to a channel [DEPRECATED]	Easily automate the process of posting a message to a Teams channel.
Post a message as the Flow bot to a user [DEPRECATED]	Easily automate the process of sending a message to someone in Teams.
Post a reply to a message (V2) [DEPRECATED]	This operation is used to post a reply to a message in a channel in a specific Team.
Post a reply to a message [DEPRECATED]	This operation is used to post a reply to a message in a channel in a specific Team.
Post adaptive card and wait for a response	Posts an adaptive card to a chat or a channel and waits for a response from any user. This will pause the flow until any user responds.
Post an Adaptive Card to a Teams channel and wait for a response [DEPRECATED]	Easily automate the process of sending a message to a Teams channel that contains actions to continue a waiting flow.
Post an Adaptive Card to a Teams user and wait for a response [DEPRECATED]	Easily automate the process of sending a message to a Teams user that contains actions to continue a waiting flow.
Post card in a chat or channel	Posts a card to a chat or a channel
Post message in a chat or channel	Posts a message to a chat or a channel
Post your own adaptive card as the Flow bot to a channel [DEPRECATED]	Add the JSON card definition to create a custom post for a Teams channel. The post can contain images, graphs, text, and more.
Post your own adaptive card as the Flow bot to a user [DEPRECATED]	Add the JSON card definition to create a custom message for a Teams user. The message can contain images, graphs, text, and more.
Reply with a message in a channel	Replies with a message to a channel's message
Reply with an adaptive card in a channel	Replies with an adaptive card to a channel's message
Send a Microsoft Graph HTTP request	Construct a Microsoft Graph REST API request to invoke against the Microsoft Team endpoints. These segments are supported: 1st segment: /teams, /me, /users 2nd segment: channels, chats, installedApps, messages, pinnedMessages. Learn more: https://docs.microsoft.com/en-us/graph/use-the-api
Shifts: Approve a Swap Shifts request [DEPRECATED]	This action has been deprecated. Please use Approve a Swap Shifts request instead. ~~This operation allows a user to approve a Swap Shifts request.~~
Shifts: Approve a Time Off request [DEPRECATED]	This action has been deprecated. Please use Approve a Time Off request instead. ~~This operation allows managers to approve a time off request.~~
Shifts: Approve an Offer Shift request [DEPRECATED]	This action has been deprecated. Please use Approve an Offer Shift request instead. ~~This operation allows recipients/managers to approve an offer shift request.~~
Shifts: Approve an Open Shift request [DEPRECATED]	This action has been deprecated. Please use Approve an Open Shift request instead. ~~This operation allows managers to approve an Open Shift request.~~
Shifts: Create a new Open Shift [DEPRECATED]	This action has been deprecated. Please use Create a new Open Shift instead. ~~Create a new open shift in a schedule~~
Shifts: Decline a Swap Shifts request [DEPRECATED]	This action has been deprecated. Please use Decline a Swap Shifts request instead. ~~This operation allows users to decline a swap shifts request.~~
Shifts: Decline a Time Off request [DEPRECATED]	This action has been deprecated. Please use Decline a Time Off request instead. ~~This operation allows managers to decline a time off request.~~
Shifts: Decline an Offer Shift request [DEPRECATED]	This action has been deprecated. Please use Decline an Offer Shift request instead. ~~This operation allows users to decline an offer shift request.~~
Shifts: Decline an Open Shift request [DEPRECATED]	This action has been deprecated. Please use Decline an Open Shift request instead. ~~This operation allows managers to decline an open shift request.~~
Shifts: Delete a shift [DEPRECATED]	This action has been deprecated. Please use Delete a Shift instead. ~~This operation deletes a shift using the shift's unique ID.~~
Shifts: Delete an open shift [DEPRECATED]	This action has been deprecated. Please use Delete an Open Shift instead. ~~This operation deletes an open shift.~~
Shifts: Get a schedule's details [DEPRECATED]	This action has been deprecated. Please use Get a Schedule's details instead. ~~This operation returns details of a schedule using the schedule's unique ID.~~
Shifts: Get a scheduling group [DEPRECATED]	This action has been deprecated. Please use Get a Scheduling Group instead. ~~This operation returns details for a scheduling group using its unique ID.~~
Shifts: Get a shift [DEPRECATED]	This action has been deprecated. Please use Get a Shift instead. ~~This operation returns details for a shift using the shift's unique ID.~~
Shifts: Get an open shift [DEPRECATED]	This action has been deprecated. Please use Get an Open Shift instead. ~~This operation returns details for an open shift.~~
Shifts: List all Offer Shift requests [DEPRECATED]	This action has been deprecated. Please use List all Offer Shift requests instead. ~~This operation returns all offer shift requests in a schedule~~
Shifts: List all Open Shift requests [DEPRECATED]	This action has been deprecated. Please use List all Open Shift requests instead. ~~This operation returns all open shift change requests in a schedule~~
Shifts: List all Open Shifts [DEPRECATED]	This action has been deprecated. Please use List all Open Shifts instead. ~~This operation returns all open shifts in a team~~
Shifts: List all scheduling groups [DEPRECATED]	This action has been deprecated. Please use List all Scheduling Groups instead. ~~This operation returns all scheduling groups in a schedule~~
Shifts: List all shifts [DEPRECATED]	This action has been deprecated. Please use List all Shifts instead. ~~This operation returns all shifts assigned to members of a team~~
Shifts: List all Swap Shifts requests [DEPRECATED]	This action has been deprecated. Please use List all Swap Shifts requests instead. ~~This operation returns all swap shifts requests in a schedule~~
Shifts: List all Time Off reasons [DEPRECATED]	This action has been deprecated. Please use List all Time Off Reasons instead. ~~This operation returns the list of time off reasons associated with a team.~~
Shifts: List all Time Off requests [DEPRECATED]	This action has been deprecated. Please use List all Time Off requests instead. ~~This operation returns all time off requests in a schedule~~
Shifts: Update an Open Shift [DEPRECATED]	This action has been deprecated. Please use Update an Open Shift instead. ~~Update an open shift in a schedule.~~
Update an adaptive card in a chat or channel	Updates an existing adaptive card

Add a member to a tag

Operation ID:: AddMemberToTag

Adds a user to a tag

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Select team
Tag	tagId	True	string	Select tag
User's ID	userId	True	string	The user's ID of the member to add to the tag, must be in a format like '550e8400-e29b-41d4-a716-446655440000'.

Returns

Body: AddMemberToTagResponseSchema

Add a member to a team

Operation ID:: AddMemberToTeam

Adds a member to a Microsoft Team

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team
User	userId	True	string	User principal name or Microsoft Entra ID to add
Set user as team owner	owner		boolean	True, if the user should be a team owner

Create a channel

Operation ID:: CreateChannel

Create a new channel within a specified team

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Select team
Description	description		string	Optional textual description for the channel
Name	displayName	True	string	Channel name as it appears in Microsoft Teams

Returns

Name	Path	Type	Description
Description	description	string	Optional textual description for the channel
Display Name	displayName	string	Channel name as it appears in Microsoft Teams
ID	id	string	The channel's unique identifier

Create a chat

Operation ID:: CreateChat

Creates a one on one or group chat

Parameters

Name	Key	Required	Type	Description
Title	topic		string	Title, displayed only in group chats
Members to add	members	True	string	User's IDs or email addresses, separated by semicolons

Returns

Response for new chat that was created

Body: NewChatResponse

Create a tag for a team

Operation ID:: CreateTag

Creates a tag in a team

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Select team
Display Name	displayName	True	string	The name of the tag as it appears to the user in Microsoft Teams.
Members' IDs	members	True	string	List of users' IDs separated by semi-colons, identifier must be in a format like '550e8400-e29b-41d4-a716-446655440000'.

Returns

The created tag for a team

Tag: CreateTagResponseSchema

Create a team

Operation ID:: CreateATeam

Creates a new Microsoft Team

Parameters

Name	Key	Required	Type	Description
Team Name	displayName	True	string	The name of the team
Description	description	True	string	An optional description for the team
Visibility	visibility		string	The visibility of the the team

Returns

Body: CreateATeamResponse

Create a Teams meeting

Operation ID:: CreateTeamsMeeting

Create a meeting with a link at the bottom of the invite to join the meeting online on Microsoft Teams.

Parameters

Name	Key	Required	Type	Description
Calendar id	calendarid	True	string	Select a value
Subject	subject	True	string	The text of the event's subject line
Event message content	content	True	string	The content of the event
Time zone	timeZone	True	string	Time zone of the event
Start time	dateTime	True	date-no-tz	Start time of the event (example: '2017-08-29T04:00:00')
End time	dateTime	True	date-no-tz	End time of the event (example: '2017-08-29T05:00:00')
Required attendees	requiredAttendees		email	Required attendees for the event separated by semicolons
Optional attendees	optionalAttendees		email	Optional attendees for the event separated by semicolons
display name	displayName		string	The name associated with the location
Importance	importance		string	The importance of the event: low, normal or high
Recurrence pattern	type		string	Pattern for the recurrence. Required when meeting is a recurrence
Recurrence interval	interval		integer	The number of units between occurrences, where units can be in days, weeks, months, or years, depending on the type. Required when meeting is a recurrence
Days of week	daysOfWeek		array of string	Comma separated days of weeks (example: 'Monday,Wednesday,Friday')
Week Index	index		string	Specifies on which day of the week the event occurs. Default is first
Recurrence start date	startDate		date	Start date of the recurrence, format YYYY-MM-DD. Required when meeting is a recurrence
Recurrence end date	endDate		date	End date of the recurrence, format YYYY-MM-DD
All day event	isAllDay		boolean	Set to true if the event lasts all day
Pre-event reminder time	reminderMinutesBeforeStart		integer	The number of minutes before the event start time that the reminder alert occurs
Enable reminders	isReminderOn		boolean	Set to true if an alert is set to remind the user of the event
Status show as	showAs		string	Status to show during the event
Request response	responseRequested		boolean	Set to true if the sender would like a response when the event is accepted

Returns

Response for new meeting that was created

Body: NewMeetingRespone

Delete a member from a tag

Operation ID:: DeleteTagMember

Deletes a member from a tag

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Select team
Tag	tagId	True	string	Select tag
Tag Member ID	tagMemberId	True	string	ID of the member to remove from the tag

Delete a tag

Operation ID:: DeleteTag

Deletes a tag from a team

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Select team
Tag	tagId	True	string	Select tag

Get a team

Operation ID:: GetTeam

Gets a Microsoft Team's details

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team

Returns

Get team response

Body: GetTeamResponse

Get an @mention token for a tag

Operation ID:: AtMentionTag

Creates a token that can be inserted into a message or adaptive card sent as a user in a channel to @mention a tag.

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Select team
Tag	tagId	True	string	Select tag

Returns

@mention token for a tag

Body: AtMentionTagResponse

Get an @mention token for a user

Operation ID:: AtMentionUser

Creates a token that can be inserted into a message or adaptive card to @mention a user.

Parameters

Name	Key	Required	Type	Description
User	userId	True	string	Specify a user principal or user ID to @mention

Returns

@mention Token

Body: AtMentionUser_V1

Get message details

Operation ID:: GetMessageDetails

Gets details of a message in a chat or a channel

Parameters

Name	Key	Required	Type	Description
Message	messageId	True	string	Message ID
Message type	threadType	True	string	Choose message type
Get message details request	body	True	dynamic	The get message details request

Returns

The outputs of this operation are dynamic.

Get messages

Operation ID:: GetMessagesFromChannel

This operation is used to get messages from a channel in a specific team

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Select team
Channel	channelId	True	string	Channel ID

Returns

Body: GetMessagesFromChannel_Response

List all tags for a team

Operation ID:: GetTags

Lists the team's tags

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Select team

Returns

Body: GetTagsResponseSchema

List channels

Operation ID:: GetChannelsForGroup

Lists all the channels for a specific team

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Select team

Returns

Name	Path	Type	Description
Channel List	value	array of object	List of one or more channels for a specific team
Description	value.description	string	Optional textual description for the channel
Name	value.displayName	string	Channel name as it appears in Microsoft Teams
ID	value.id	string	The channel's unique identifier

List chats

Operation ID:: GetChats

Lists recent chats you are a part of

Parameters

Name	Key	Required	Type	Description
Chat Types	chatType	True	string	Filter by type
Topic	topic	True	string	Filter by whether or not the topic name is defined

Returns

Name	Path	Type	Description
Chats List	value	array of object	List of one or more chats you are a part of
Topic	value.topic	string	Subject or topic for the chat. Only available for group chats
Created Date Time	value.createdDateTime	date-time	Date and time when the chat was created
Last Updated Date Time	value.lastUpdatedDateTime	date-time	Date and time of when the chat was last renamed or its member list was last updated
Conversation ID	value.id	string	The chat's unique identifier

List members

Operation ID:: ListMembers

List members of a group chat

Parameters

Name	Key	Required	Type	Description
Thread type	threadType	True	string	Choose message type
List members request	body	True	dynamic	The list members request

Returns

List members response schema

Body: ListMembersResponseSchema

List teams

Operation ID:: GetAllTeams

Lists all the Microsoft Teams you are a member of

Returns

Name	Path	Type	Description
Teams List	value	array of object	List of the teams you are a part of
Description	value.description	string	An optional description for the team
Name	value.displayName	string	The name of the team
ID	value.id	string	The team's unique identifier, also called an Microsoft 365 Group ID

List the members of a tag

Operation ID:: GetTagMembers

Lists the members of a tag

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Select team
Tag	tagId	True	string	Select tag

Returns

Body: GetTagMembersResponseSchema

Post a choice of options as the Flow bot to a user

Operation ID:: SubscribeUserMessageWithOptions

Send a set of options to a Microsoft Team's user, that they must respond to before the flow will continue. This action will pause the flow until the user response to the options

Parameters

Name	Key	Required	Type	Description
User message with options subscription request	UserMessageWithOptionsSubscriptionRequest	True	dynamic	The user message with options subscription request

Returns

The outputs of this operation are dynamic.

Post a feed notification

Operation ID:: PostFeedNotification

Posts a notification to a user's activity feed linking to a chat or team.

Parameters

Name	Key	Required	Type	Description
Post as	poster	True	string	Select an option
Notification type	notificationType	True	string	Choose notification type
Post feed notification request	body	True	dynamic	The post feed notification request

Post a message (V2) [DEPRECATED]

Operation ID:: PostMessageToChannelV2

This operation is used to post a message to a channel in a specific Team.

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Select team
Channel	channelId	True	string	Channel ID
Subject	subject		string	Subject of the message.
Message	content	True	string	Body of the message.
Type	contentType	True	string	Content type: html or text.

Post a message (V3) [DEPRECATED]

Operation ID:: PostMessageToChannelV3

This operation is used to post a message to a channel in a specific Team.

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Select team
Channel	channelId	True	string	Channel ID
Subject	subject		string	Subject of the message.
Message	content	True	html	Body of the message.

Returns

Body: MessageId

Post a message [DEPRECATED]

Operation ID:: PostMessageToChannel

This operation is used to post a message to a channel in a specific Team.

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Select team
Channel	channelId	True	string	Channel ID
Message	content	True	html	Body of the message.

Post a message as the Flow bot to a channel [DEPRECATED]

Operation ID:: PostChannelNotification

Easily automate the process of posting a message to a Teams channel.

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Select team
Post notification request	PostNotificationRequest	True	dynamic	The post notification request

Post a message as the Flow bot to a user [DEPRECATED]

Operation ID:: PostUserNotification

Easily automate the process of sending a message to someone in Teams.

Parameters

Name	Key	Required	Type	Description
Post notification request	PostNotificationRequest	True	dynamic	The post notification request

Post a reply to a message (V2) [DEPRECATED]

Operation ID:: PostReplyToMessageV2

This operation is used to post a reply to a message in a channel in a specific Team.

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Select team
Channel	channelId	True	string	Channel ID
Message	messageId	True	string	Message ID
Subject	subject		string	Subject of the message.
Reply	content	True	html	Body of the message.

Post a reply to a message [DEPRECATED]

Operation ID:: PostReplyToMessage

This operation is used to post a reply to a message in a channel in a specific Team.

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Select team
Channel	channelId	True	string	Channel ID
Message	messageId	True	string	Message ID
Subject	subject		string	Subject of the message.
Reply	content	True	string	Body of the message.
Type	contentType	True	string	Content type: html or text.

Post adaptive card and wait for a response

Operation ID:: PostCardAndWaitForResponse

Posts an adaptive card to a chat or a channel and waits for a response from any user. This will pause the flow until any user responds.

Parameters

Name	Key	Required	Type	Description
Post as	poster	True	string	Select an option
Post in	location	True	string	Select an option
Flow continuation subscription request	body	True	dynamic	The flow continuation subscription request

Returns

The outputs of this operation are dynamic.

Post an Adaptive Card to a Teams channel and wait for a response [DEPRECATED]

Operation ID:: SubscribeChannelFlowContinuation

Easily automate the process of sending a message to a Teams channel that contains actions to continue a waiting flow.

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Select team
Update message	updateMessage		string	Message to be included in an update to the original card following response
Should update card	shouldUpdateCard		boolean	Whether or not to update the card following response
Channel	channelId	True	string	Add channel ID
Message	messageBody	True	string

Returns

The outputs of this operation are dynamic.

Post an Adaptive Card to a Teams user and wait for a response [DEPRECATED]

Operation ID:: SubscribeUserFlowContinuation

Easily automate the process of sending a message to a Teams user that contains actions to continue a waiting flow.

Parameters

Name	Key	Required	Type	Description
Update message	updateMessage		string	Message to be included in an update to the original card following response
Should update card	shouldUpdateCard		boolean	Whether or not to update the card following response
Recipient	to	True	string	Add an email address
Summary	summary		string	The message summary
IsAlert	isAlert		boolean	If the message will be shown in the activity feed
Message	messageBody	True	string

Returns

The outputs of this operation are dynamic.

Post card in a chat or channel

Operation ID:: PostCardToConversation

Posts a card to a chat or a channel

Parameters

Name	Key	Required	Type	Description
Post as	poster	True	string	Select an option
Post in	location	True	string	Select an option
Post card request	body	True	dynamic	The post card request

Returns

Body: PostToConversationResponse

Post message in a chat or channel

Operation ID:: PostMessageToConversation

Posts a message to a chat or a channel

Parameters

Name	Key	Required	Type	Description
Post as	poster	True	string	Select an option
Post in	location	True	string	Select an option
Post message request	body	True	dynamic	The post message request

Returns

Body: PostToConversationResponse

Post your own adaptive card as the Flow bot to a channel [DEPRECATED]

Operation ID:: PostChannelAdaptiveCard

Add the JSON card definition to create a custom post for a Teams channel. The post can contain images, graphs, text, and more.

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Select team
Post adaptive card request	PostAdaptiveCardRequest	True	dynamic	The post adaptive card request

Returns

Body: MessageId

Post your own adaptive card as the Flow bot to a user [DEPRECATED]

Operation ID:: PostUserAdaptiveCard

Add the JSON card definition to create a custom message for a Teams user. The message can contain images, graphs, text, and more.

Parameters

Name	Key	Required	Type	Description
Post adaptive card request	PostAdaptiveCardRequest	True	dynamic	The post adaptive card request

Returns

Body: MessageId

Reply with a message in a channel

Operation ID:: ReplyWithMessageToConversation

Replies with a message to a channel's message

Parameters

Name	Key	Required	Type	Description
Post as	poster	True	string	Select an option
Post in	location	True	string	Select an option
Reply message request	body	True	dynamic	The reply message request

Returns

Body: PostToConversationResponse

Reply with an adaptive card in a channel

Operation ID:: ReplyWithCardToConversation

Replies with an adaptive card to a channel's message

Parameters

Name	Key	Required	Type	Description
Post as	poster	True	string	Select an option
Post in	location	True	string	Select an option
Reply adaptive card request	body	True	dynamic	The reply adaptive card request

Returns

Body: PostToConversationResponse

Send a Microsoft Graph HTTP request

Operation ID:: HttpRequest

Construct a Microsoft Graph REST API request to invoke against the Microsoft Team endpoints. These segments are supported: 1st segment: /teams, /me, /users 2nd segment: channels, chats, installedApps, messages, pinnedMessages. Learn more: https://docs.microsoft.com/en-us/graph/use-the-api

Parameters

Name	Key	Required	Type	Description
URI	Uri	True	string	The full or relative URI. Example: https://graph.microsoft.com/{version}/{resource}
Method	Method	True	string	The HTTP method (default is GET)
Body	Body		binary	The request body content
Content-Type	ContentType		string	The content-type header for the body (default is application/json)
CustomHeader1	CustomHeader1		string	Custom header 1. Specify in format: header-name: header-value
CustomHeader2	CustomHeader2		string	Custom header 2. Specify in format: header-name: header-value
CustomHeader3	CustomHeader3		string	Custom header 3. Specify in format: header-name: header-value
CustomHeader4	CustomHeader4		string	Custom header 4. Specify in format: header-name: header-value
CustomHeader5	CustomHeader5		string	Custom header 5. Specify in format: header-name: header-value

Returns

response: ObjectWithoutType

Shifts: Approve a Swap Shifts request [DEPRECATED]

Operation ID:: SwapShiftsChangeRequestApprove

This action has been deprecated. Please use Approve a Swap Shifts request instead.

~~This operation allows a user to approve a Swap Shifts request.~~

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team
Swap Shifts Change Request ID	swapShiftsChangeRequestId	True	string	The unique ID of the request
Message From Recipient/Manager	message		string	A message when a request is accepted.

Returns

Shifts: Approve a Time Off request [DEPRECATED]

Operation ID:: TimeOffRequestApprove

This action has been deprecated. Please use Approve a Time Off request instead.

~~This operation allows managers to approve a time off request.~~

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team
Time Off Request ID	timeOffRequestId	True	string	The unique ID of the time off request
Message From Manager	message		string	A message from the manager to the sender/recipient when a request is accepted.

Returns

Shifts: Approve an Offer Shift request [DEPRECATED]

Operation ID:: OfferShiftRequestApprove

This action has been deprecated. Please use Approve an Offer Shift request instead.

~~This operation allows recipients/managers to approve an offer shift request.~~

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team
Offer Shift Request ID	offerShiftRequestId	True	string	The unique ID of the offer shift request
Message From Recipient/Manager	message		string	A message when a request is accepted.

Returns

Shifts: Approve an Open Shift request [DEPRECATED]

Operation ID:: OpenShiftChangeRequestApprove

This action has been deprecated. Please use Approve an Open Shift request instead.

~~This operation allows managers to approve an Open Shift request.~~

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team
Open Shift Change Request ID	openShiftChangeRequestId	True	string	The unique ID of the request
Message From Manager	message		string	A message from the manager to the sender/recipient when a request is accepted.

Returns

Shifts: Create a new Open Shift [DEPRECATED]

Operation ID:: CreateOpenShift

This action has been deprecated. Please use Create a new Open Shift instead.

~~Create a new open shift in a schedule~~

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team
Scheduling Group ID	schedulingGroupId		string	Scheduling Group ID
Display Name	displayName		string	Display Name
Notes	notes		string	Notes
From Start Time	startDateTime	True	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
To End Time	endDateTime	True	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Theme	theme		string	Theme
Open Slot Count	openSlotCount	True	integer	Open Slot Count
Is Paid	isPaid		boolean	Is Paid
From Start Time	startDateTime	True	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
To End Time	endDateTime	True	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Code	code		string	Code
Display Name	displayName		string	Display Name

Returns

Open Shift Entity

Open Shift: OpenShiftResponse

Shifts: Decline a Swap Shifts request [DEPRECATED]

Operation ID:: SwapShiftsChangeRequestDecline

This action has been deprecated. Please use Decline a Swap Shifts request instead.

~~This operation allows users to decline a swap shifts request.~~

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team
Swap Shifts Change Request ID	swapShiftsChangeRequestId	True	string	The unique ID of the request
Message From Recipient/Manager	message		string	A message when a request is declined.

Returns

Shifts: Decline a Time Off request [DEPRECATED]

Operation ID:: TimeOffRequestDecline

This action has been deprecated. Please use Decline a Time Off request instead.

~~This operation allows managers to decline a time off request.~~

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team
Time Off Request ID	timeOffRequestId	True	string	The unique ID of the time off request
Message From Manager	message		string	A message from the manager to the sender/recipient when a request is declined.

Returns

Shifts: Decline an Offer Shift request [DEPRECATED]

Operation ID:: OfferShiftRequestDecline

This action has been deprecated. Please use Decline an Offer Shift request instead.

~~This operation allows users to decline an offer shift request.~~

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team
Offer Shift Request ID	offerShiftRequestId	True	string	The unique ID of the offer shift request
Message From Recipient/Manager	message		string	A message when a request is declined.

Returns

Shifts: Decline an Open Shift request [DEPRECATED]

Operation ID:: OpenShiftChangeRequestDecline

This action has been deprecated. Please use Decline an Open Shift request instead.

~~This operation allows managers to decline an open shift request.~~

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team
Open Shift Change Request ID	openShiftChangeRequestId	True	string	The unique ID of the request
Message From Manager	message		string	A message from the manager to the sender/recipient when a request is declined.

Returns

Shifts: Delete a shift [DEPRECATED]

Operation ID:: DeleteShift

This action has been deprecated. Please use Delete a Shift instead.

~~This operation deletes a shift using the shift's unique ID.~~

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team
Shift ID	shiftId	True	string	The unique ID of the shift.

Shifts: Delete an open shift [DEPRECATED]

Operation ID:: DeleteOpenShift

This action has been deprecated. Please use Delete an Open Shift instead.

~~This operation deletes an open shift.~~

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team
Open Shift ID	openShiftId	True	string	The unique ID of the open shift.

Shifts: Get a schedule's details [DEPRECATED]

Operation ID:: GetSchedule

This action has been deprecated. Please use Get a Schedule's details instead.

~~This operation returns details of a schedule using the schedule's unique ID.~~

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team

Returns

Schedule Entity

Body: ScheduleResponse

Shifts: Get a scheduling group [DEPRECATED]

Operation ID:: GetSchedulingGroup

This action has been deprecated. Please use Get a Scheduling Group instead.

~~This operation returns details for a scheduling group using its unique ID.~~

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team
Scheduling Group ID	schedulingGroupId	True	string	The unique ID of the Scheduling Group.

Returns

Scheduling Group Entity

Scheduling Group: SchedulingGroupResponse

Shifts: Get a shift [DEPRECATED]

Operation ID:: GetShift

This action has been deprecated. Please use Get a Shift instead.

~~This operation returns details for a shift using the shift's unique ID.~~

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team
Shift ID	shiftId	True	string	The unique ID of the shift.

Returns

Shift Entity

Shift: ShiftResponse

Shifts: Get an open shift [DEPRECATED]

Operation ID:: GetOpenShift

This action has been deprecated. Please use Get an Open Shift instead.

~~This operation returns details for an open shift.~~

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team
Open Shift ID	openShiftId	True	string	The unique ID of the open shift.

Returns

Open Shift Entity

Open Shift: OpenShiftResponse

Shifts: List all Offer Shift requests [DEPRECATED]

Operation ID:: ListOfferShiftRequests

This action has been deprecated. Please use List all Offer Shift requests instead.

~~This operation returns all offer shift requests in a schedule~~

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team
Top Count	$top		integer	Total number of requests to retrieve
Request State	state		string	Request state filter

Returns

Name	Path	Type	Description
Offer Shift Requests List	value	array of OfferShiftRequestResponse	List of Offer Shift requests in the schedule

Shifts: List all Open Shift requests [DEPRECATED]

Operation ID:: ListOpenShiftChangeRequests

This action has been deprecated. Please use List all Open Shift requests instead.

~~This operation returns all open shift change requests in a schedule~~

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team
Top Count	$top		integer	Total number of requests to retrieve
Request State	state		string	Request state filter

Returns

Name	Path	Type	Description
Open Shift Change Requests List	value	array of OpenShiftChangeRequestResponse	List of Open Shift Change Requests in the schedule

Shifts: List all Open Shifts [DEPRECATED]

Operation ID:: ListOpenShifts

This action has been deprecated. Please use List all Open Shifts instead.

~~This operation returns all open shifts in a team~~

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team
From Start Time	startTime		date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
To End Time	endTime		date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Top Count	$top		integer	Total number of open shifts to retrieve

Returns

Name	Path	Type	Description
Open Shifts List	value	array of OpenShiftResponse	List of open shifts in the schedule

Shifts: List all scheduling groups [DEPRECATED]

Operation ID:: ListSchedulingGroups

This action has been deprecated. Please use List all Scheduling Groups instead.

~~This operation returns all scheduling groups in a schedule~~

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team
Top Count	$top		integer	Total number of entries to retrieve

Returns

Name	Path	Type	Description
Scheduling Groups List	value	array of SchedulingGroupResponse	List of schedule groups in the schedule

Shifts: List all shifts [DEPRECATED]

Operation ID:: ListShifts

This action has been deprecated. Please use List all Shifts instead.

~~This operation returns all shifts assigned to members of a team~~

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team
From Start Time	startTime		date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
To End Time	endTime		date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Top Count	$top		integer	Total number of shifts to retrieve

Returns

Name	Path	Type	Description
Shifts List	value	array of ShiftResponse	List of shifts in the schedule

Shifts: List all Swap Shifts requests [DEPRECATED]

Operation ID:: ListSwapShiftsChangeRequests

This action has been deprecated. Please use List all Swap Shifts requests instead.

~~This operation returns all swap shifts requests in a schedule~~

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team
Top Count	$top		integer	Total number of requests to retrieve
Request State	state		string	Request state filter

Returns

Name	Path	Type	Description
Swap Shifts Change Requests List	value	array of SwapShiftsChangeRequestResponse	List of Swap Shifts Change Requests in the schedule

Shifts: List all Time Off reasons [DEPRECATED]

Operation ID:: ListTimeOffReasons

This action has been deprecated. Please use List all Time Off Reasons instead.

~~This operation returns the list of time off reasons associated with a team.~~

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team
Top Count	$top		integer	Total number of Time Off reasons to retrieve

Returns

The list of Time Off Reasons.

List of time off reasons associated with a team: GetTimeOffReasonsResponse

Shifts: List all Time Off requests [DEPRECATED]

Operation ID:: ListTimeOffRequests

This action has been deprecated. Please use List all Time Off requests instead.

~~This operation returns all time off requests in a schedule~~

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team
Top Count	$top		integer	Total number of requests to retrieve
Request State	state		string	Request state filter

Returns

Name	Path	Type	Description
TimeOff Requests List	value	array of TimeOffRequestResponse	List of Time Off requests in the schedule

Shifts: Update an Open Shift [DEPRECATED]

Operation ID:: UpdateOpenShift

This action has been deprecated. Please use Update an Open Shift instead.

~~Update an open shift in a schedule.~~

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Select team
Open Shift ID	openShiftId	True	string	The unique ID of the open shift.
Scheduling Group ID	schedulingGroupId		string	Scheduling Group ID
Display Name	displayName		string	Display Name
Notes	notes		string	Notes
From Start Time	startDateTime	True	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
To End Time	endDateTime	True	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Theme	theme		string	Theme
Open Slot Count	openSlotCount	True	integer	Open Slot Count
Is Paid	isPaid		boolean	Is Paid
From Start Time	startDateTime	True	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
To End Time	endDateTime	True	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Code	code		string	Code
Display Name	displayName		string	Display Name

Returns

Open Shift Entity

Open Shift: OpenShiftResponse

Update an adaptive card in a chat or channel

Operation ID:: UpdateCardInConversation

Updates an existing adaptive card

Parameters

Name	Key	Required	Type	Description
Post as	poster	True	string	Select an option
Post in	location	True	string	Select an option
Update adaptive card request	body	True	dynamic	The update adaptive card request

Triggers

For a selected message (V2)	This trigger allows you to start a flow for a selected message in Microsoft Teams. (Available only for Power Automate.)
From the compose box (V2)	This trigger allows you to start a flow from the compose message box in Microsoft Teams. (Available only for Power Automate.)
When a new channel message is added	Triggers when a new message is posted to a channel in a team. Note that this trigger only fires when a root messages is added in the channel. Replies to an existing channel message will not result in the trigger event firing.
When a new chat message is added	Triggers when a new message is posted in any chat the user is a part of.
When a new team member is added	Triggers when a member is added to the given team
When a new team member is removed	Triggers when a member is removed from the specified team
When I'm @mentioned	Triggers when a new message that @mentions the current user is added to a specified chat or channel.
When I am mentioned in a channel message	Triggers when a new message that @mentions the current user is added to a channel in a team.
When keywords are mentioned	Triggers when a keyword is mentioned in a specified chat or channel. Does not trigger if a message is edited.
When someone responds to an adaptive card	This trigger allows you to handle responses for an adaptive card posted in Microsoft Teams. (Available only for Power Automate.)

For a selected message (V2)

Operation ID:: OnMessageSelectedV2

This trigger allows you to start a flow for a selected message in Microsoft Teams. (Available only for Power Automate.)

Parameters

Name	Key	Required	Type
operationId	operationId	True	string
host	host		object
parameters	parameters	True	object
schema	schema		object

Returns

Name	Path	Type	Description
body	body	object

From the compose box (V2)

Operation ID:: OnComposeMessageV2

This trigger allows you to start a flow from the compose message box in Microsoft Teams. (Available only for Power Automate.)

Parameters

Name	Key	Required	Type
operationId	operationId	True	string
host	host		object
parameters	parameters	True	object
schema	schema		object

Returns

Name	Path	Type	Description
body	body	object

When a new channel message is added

Operation ID:: OnNewChannelMessage

Triggers when a new message is posted to a channel in a team. Note that this trigger only fires when a root messages is added in the channel. Replies to an existing channel message will not result in the trigger event firing.

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Select team
Channel	channelId	True	string	Channel ID

Returns

Name	Path	Type	Description
attachments	attachments	array of object	attachments
items	attachments	object
content	body.content	string	The content of the message
content type	body.contentType	string	The type of the content. Possible values are text and html
creation timestamp	createdDateTime	date-time	Timestamp of when the chat message was created
deleted	deleted	boolean	deleted
etag	etag	string	Version number of the chat message.
application	from.application	object	application
device	from.device	string	device
display name	from.user.displayName	string	display name
ID	from.user.id	string	user's identifier
identityProvider	from.user.identityProvider	string	identityProvider
id	id	string	Unique ID of the message
importance	importance	string	The importance of the message. The possible values are: normal, high, urgent.
last modified timestamp	lastModifiedDateTime	string	Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed
locale	locale	string	Locale of the chat message set by the client.
mentions	mentions	array of object	List of entities mentioned in the chat message. Supported entities are: user, bot, team, and channel.
items	mentions	object
messageType	messageType	string	The type of chat message
reactions	reactions	array of object	Reactions for this chat message (for example, Like)
items	reactions	object
replyToId	replyToId	string	ID of the parent message of the thread
subject	subject	string	The subject of the chat message, optional
summary	summary	string	Summary text of the message that could be used for push notifications and summary views or fall back views

When a new chat message is added

Operation ID:: WebhookChatMessageTrigger

Triggers when a new message is posted in any chat the user is a part of.

Returns

Message details

Body: ChatMessageWebhookResponseSchema

When a new team member is added

Operation ID:: OnGroupMembershipAdd

Triggers when a member is added to the given team

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Select team

Returns

Name	Path	Type	Description
User ID	id	string	Unique id of the user

When a new team member is removed

Operation ID:: OnGroupMembershipRemoval

Triggers when a member is removed from the specified team

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Select team

Returns

Name	Path	Type	Description
User ID	id	string	Unique id of the user

When I'm @mentioned

Operation ID:: WebhookAtMentionTrigger

Triggers when a new message that @mentions the current user is added to a specified chat or channel.

Parameters

Name	Key	Required	Type	Description
Message type	threadType	True	string	Choose message type
requestBody	requestBody		dynamic	This is the request body of the Webhook

Returns

The outputs of this operation are dynamic.

When I am mentioned in a channel message

Operation ID:: OnNewChannelMessageMentioningMe

Triggers when a new message that @mentions the current user is added to a channel in a team.

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Select team
Channel	channelId	True	string	Channel ID

Returns

Name	Path	Type	Description
attachments	attachments	array of object	attachments
items	attachments	object
content	body.content	string	The content of the message
content type	body.contentType	string	The type of the content. Possible values are text and html
creation timestamp	createdDateTime	date-time	Timestamp of when the chat message was created
deleted	deleted	boolean	deleted
etag	etag	string	Version number of the chat message.
application	from.application	object	application
device	from.device	string	device
display name	from.user.displayName	string	display name
ID	from.user.id	string	user's identifier
identityProvider	from.user.identityProvider	string	identityProvider
id	id	string	Unique ID of the message
importance	importance	string	The importance of the message. The possible values are: normal, high, urgent.
last modified timestamp	lastModifiedDateTime	string	Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed
locale	locale	string	Locale of the chat message set by the client.
mentions	mentions	array of object	List of entities mentioned in the chat message. Supported entities are: user, bot, team, and channel.
items	mentions	object
messageType	messageType	string	The type of chat message
reactions	reactions	array of object	Reactions for this chat message (for example, Like)
items	reactions	object
replyToId	replyToId	string	ID of the parent message of the thread
subject	subject	string	The subject of the chat message, optional
summary	summary	string	Summary text of the message that could be used for push notifications and summary views or fall back views

When keywords are mentioned

Operation ID:: WebhookKeywordTrigger

Triggers when a keyword is mentioned in a specified chat or channel. Does not trigger if a message is edited.

Parameters

Name	Key	Required	Type	Description
Message type	threadType	True	string	Choose message type
Keywords to search for	$search	True	string	A comma separated list of keywords to search for
requestBody	requestBody		dynamic	This is the request body of the Webhook

Returns

The outputs of this operation are dynamic.

When someone responds to an adaptive card

Operation ID:: TeamsCardTrigger

This trigger allows you to handle responses for an adaptive card posted in Microsoft Teams. (Available only for Power Automate.)

Returns

The outputs of this operation are dynamic.

Definitions

GetTagsResponseSchema

Name	Path	Type	Description
value	value	array of object
ID	value.id	string	Unique identifier of the tag
Team ID	value.teamId	string	ID of the team in which the tag is defined
Display name	value.displayName	string	The name of the tag as it appears to the user in Microsoft Teams.
Member count	value.memberCount	integer	The number of users assigned to the tag

GetTagMembersResponseSchema

Name	Path	Type	Description
value	value	array of object
Tag member ID	value.id	string	The unique identifier for the member
Tenant ID	value.tenantId	string	The ID of the tenant that the tag member is a part of
User display name	value.displayName	string	The member's display name
User ID	value.userId	string	The user ID of the member

CreateTagResponseSchema

The created tag for a team

Name	Path	Type	Description
ID	id	string	Unique identifier of the tag
Team ID	teamId	string	ID of the team in which the tag is defined
Display name	displayName	string	The name of the tag as it appears to the user in Microsoft Teams.
Member count	memberCount	integer	The number of users assigned to the tag

AddMemberToTagResponseSchema

Name	Path	Type	Description
ID	userId	string	User ID of the member added to the tag

ListMembersResponseSchema

List members response schema

Name	Path	Type	Description
List of members	value	array of object	List members response
Display Name	value.displayName	string	Display name of the member
E-Mail	value.email	string	Email address of the member
ID	value.id	string	Member's user ID
Roles	value.roles	array of string	The roles for that member
Tenant ID	value.tenantId	string	Tenant ID of the member
User ID	value.userId	string	User ID of the member
Start time of conversation's visible history	value.visibleHistoryStartDateTime	string	The timestamp denoting how far back a conversation's history is shared with the conversation member

ChatMessageWebhookResponseSchema

Message details

Name	Path	Type	Description
Message	value	array of object	Message details response
Conversation ID	value.conversationId	string	The chat's unique identifier
ID	value.messageId	string	Message ID
Link	value.linkToMessage	string	Message link

MessageId

Name	Path	Type	Description
Message ID	id	string	Unique message identifier

GetMessagesFromChannel_Response

Name	Path	Type	Description
@odata.context	@odata.context	string	@odata.context
@odata.count	@odata.count	integer	@odata.count
@odata.nextLink	@odata.nextLink	string	@odata.nextLink
Message List	value	OnNewChannelMessage_Response	List of one or more messages for a specific channel in a team

OnNewChannelMessage_Response

List of one or more messages for a specific channel in a team

Name	Path	Type	Description
attachments	attachments	array of object	attachments
items	attachments	object
content	body.content	string	The content of the message
content type	body.contentType	string	The type of the content. Possible values are text and html
creation timestamp	createdDateTime	date-time	Timestamp of when the chat message was created
deleted	deleted	boolean	deleted
etag	etag	string	Version number of the chat message.
application	from.application	object	application
device	from.device	string	device
display name	from.user.displayName	string	display name
ID	from.user.id	string	user's identifier
identityProvider	from.user.identityProvider	string	identityProvider
id	id	string	Unique ID of the message
importance	importance	string	The importance of the message. The possible values are: normal, high, urgent.
last modified timestamp	lastModifiedDateTime	string	Timestamp when the chat message is created (initial setting) or modified, including when a reaction is added or removed
locale	locale	string	Locale of the chat message set by the client.
mentions	mentions	array of object	List of entities mentioned in the chat message. Supported entities are: user, bot, team, and channel.
items	mentions	object
messageType	messageType	string	The type of chat message
reactions	reactions	array of object	Reactions for this chat message (for example, Like)
items	reactions	object
replyToId	replyToId	string	ID of the parent message of the thread
subject	subject	string	The subject of the chat message, optional
summary	summary	string	Summary text of the message that could be used for push notifications and summary views or fall back views

GetTeamResponse

Get team response

Name	Path	Type	Description
Team ID	id	string	The unique identifier of the team
Display name	displayName	string	The name of the team
Description of team	description	string	The description of the team, optional
Internal ID	internalId	string	The internal ID of the team
Team's web url	webUrl	string	A hyperlink that will go to the team in the Microsoft Teams client
Archived	isArchived	boolean	Whether this team is in read-only mode
Member settings	memberSettings	MemberSettings	Settings to configure whether members can perform certain actions, for example, create channels and add bots, in the team
Guest settings	guestSettings	GuestSettings	Settings to configure whether guests can create, update, or delete channels in the team
Messaging settings	messagingSettings	MessagingSettings	Settings to configure messaging and mentions in the team
Fun settings	funSettings	FunSettings	Settings to configure use of Giphy, memes, and stickers in the team
Discovery settings	discoverySettings	DiscoverySettings	Settings to configure team discoverability by others.

GetTimeOffReasonsResponse

The list of Time Off Reasons.

Name	Path	Type	Description
Array containing time off reasons	value	array of object	The list of time off reasons.
Time Off Reason ID	value.id	string	The unique ID of the time off reason.
Created Time	value.createdDateTime	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Modified Date Time	value.lastModifiedDateTime	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Display Name	value.displayName	string	Display Name
Icon Type	value.iconType	string	Icon Type
Is Active	value.isActive	boolean	Is Active
Last Modified By	value.lastModifiedBy	LastModifiedBy	Last Modified By

TimeOffRequestResponse

TimeOff Request Entity

Name	Path	Type	Description
ID	id	string	The unique ID of the TimeOff request.
Created Time	createdDateTime	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Modified Time	lastModifiedDateTime	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Assigned To	assignedTo	string	The person the request is assigned to: 'manager' or 'recipient'
State	state	string	'approved', 'pending' or 'declined'
Sender Time	senderDateTime	date-time	Time when the request was sent
Sender Message	senderMessage	string	The message from the request sender
Sender ID	senderUserId	string	The ID of the user that sent the request
Manager Action Time	managerActionDateTime	date-time	Time when the manager responded
Manager Message	managerActionMessage	string	The message from the manager
Manager ID	managerUserId	string	The ID of the manager that responded
From Start Time	startDateTime	date-time	Start of time requested off
To End Time	endDateTime	date-time	End of time requested off
TimeOff Reason ID	timeOffReasonId	string	The ID of the TimeOff Reason

OfferShiftRequestResponse

Offer Shift Request Entity

Name	Path	Type	Description
ID	id	string	The unique ID of the Offer Shift request.
Created Time	createdDateTime	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Modified Time	lastModifiedDateTime	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Assigned To	assignedTo	string	The person the request is assigned to: 'manager' or 'recipient'
State	state	string	'approved', 'pending' or 'declined'
Sender Time	senderDateTime	date-time	Time when the request was sent
Sender Message	senderMessage	string	The message from the request sender
Sender ID	senderUserId	string	The ID of the user that sent the request
Sender Shift ID	senderShiftId	string	The ID of the shift from the sender
Receiver Time	recipientActionDateTime	date-time	Time when the recipient responded
Recipient Message	recipientActionMessage	string	The message from the recipient
Recipient ID	recipientUserId	string	The ID of the recipient of the request
Manager Action Time	managerActionDateTime	date-time	Time when the manager responded
Manager Message	managerActionMessage	string	The message from the manager
Manager ID	managerUserId	string	The ID of the manager that responded

SwapShiftsChangeRequestResponse

Swap Shift Request Entity

Name	Path	Type	Description
ID	id	string	The unique ID of the Swap Shift request.
Created Time	createdDateTime	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Modified Time	lastModifiedDateTime	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Assigned To	assignedTo	string	The person the request is assigned to: 'manager' or 'recipient'
State	state	string	'approved', 'pending' or 'declined'
Sender Time	senderDateTime	date-time	Time when the request was sent
Sender Message	senderMessage	string	The message from the request sender
Sender ID	senderUserId	string	The ID of the user that sent the request
Sender Shift ID	senderShiftId	string	The ID of the shift from the sender
Receiver Time	recipientActionDateTime	date-time	Time when the recipient responded
Recipient Message	recipientActionMessage	string	The message from the recipient
Recipient ID	recipientUserId	string	The ID of the recipient of the request
Recipient Shift ID	recipientShiftId	string	The ID of the shift from the recipient
Manager Action Time	managerActionDateTime	date-time	Time when the manager responded
Manager Message	managerActionMessage	string	The message from the manager
Manager ID	managerUserId	string	The ID of the manager that responded

OpenShiftChangeRequestResponse

Open Shift Change Request Entity

Name	Path	Type	Description
ID	id	string	The unique ID of the Open Shift Change request.
Created Time	createdDateTime	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Modified Time	lastModifiedDateTime	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Assigned To	assignedTo	string	The person the request is assigned to: 'manager' or 'recipient'
State	state	string	'approved', 'pending' or 'declined'
Sender Time	senderDateTime	date-time	Time when the request was sent
Sender Message	senderMessage	string	The message from the request sender
Sender ID	senderUserId	string	The ID of the user that sent the request
Manager Action Time	managerActionDateTime	date-time	Time when the manager responded
Manager Message	managerActionMessage	string	The message from the manager
Manager ID	managerUserId	string	The ID of the manager that responded
Open Shift ID	openShiftId	string	The ID of the open shift being requested

OpenShiftResponse

Open Shift Entity

Name	Path	Type	Description
ID	id	string	The unique ID of the open shift.
Created Date Time	createdDateTime	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Modified Date Time	lastModifiedDateTime	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Scheduling Group ID	schedulingGroupId	string	Scheduling Group ID
Last Modified By	lastModifiedBy	LastModifiedBy	Last Modified By
Shared Open Shift	sharedOpenShift	SharedOpenShift	Shared version of the open shift
Draft Open Shift	draftOpenShift	DraftOpenShift	Preliminary version of the open shift

SharedOpenShift

Shared version of the open shift

Name	Path	Type	Description
Display Name	displayName	string	Display Name
Notes	notes	string	Notes
From Start Time	startDateTime	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
To End Time	endDateTime	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Theme	theme	string	Theme
Open Slot Count	openSlotCount	integer	Open Slot Count
activities	activities	Activities	Shift activities

DraftOpenShift

Preliminary version of the open shift

Name	Path	Type	Description
Display Name	displayName	string	Display Name
Notes	notes	string	Notes
From Start Time	startDateTime	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
To End Time	endDateTime	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Theme	theme	string	Theme
Open Slot Count	openSlotCount	integer	Open Slot Count
activities	activities	Activities	Shift activities

ShiftResponse

Shift Entity

Name	Path	Type	Description
ID	id	string	The unique ID of the shift.
Created Date Time	createdDateTime	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Modified Date Time	lastModifiedDateTime	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Assigned To User ID	userId	string	Assigned To User ID
Scheduling Group ID	schedulingGroupId	string	Scheduling Group ID
Last Modified By	lastModifiedBy	LastModifiedBy	Last Modified By
Shared Shift	sharedShift	SharedShift	Shared version of the shift
Draft Shift	draftShift	DraftShift	Preliminary version of the shift

SharedShift

Shared version of the shift

Name	Path	Type	Description
Display Name	displayName	string	Display Name
Notes	notes	string	Notes
From Start Time	startDateTime	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
To End Time	endDateTime	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Theme	theme	string	Theme
activities	activities	Activities	Shift activities

DraftShift

Preliminary version of the shift

Name	Path	Type	Description
Display Name	displayName	string	Display Name
Notes	notes	string	Notes
From Start Time	startDateTime	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
To End Time	endDateTime	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Theme	theme	string	Theme
activities	activities	Activities	Shift activities

ScheduleResponse

Schedule Entity

Name	Path	Type	Description
Schedule ID	id	string	The unique ID of the schedule.
Schedule Time Zone	timeZone	string	The Time Zone of the schedule.
Schedule Provision Status	provisionStatus	string	The Provision Status of the schedule.
Schedule Provision Status Code	provisionStatusCode	string	The Provision Status Code of the schedule.

CreateATeamResponse

Name	Path	Type	Description
New Team ID	newTeamId	string	Team ID of the team that was just created

PostToConversationResponse

Name	Path	Type	Description
Message ID	id	string	Unique message ID
Message link	messageLink	string	Link to the message in Microsoft Teams
Conversation ID	conversationId	string	The chat's unique identifier

Activities

Shift activities

Name	Path	Type	Description
Is Paid	isPaid	boolean	Is Paid
From Start Time	startDateTime	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
To End Time	endDateTime	date-time	yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)
Code	code	string	Code
Display Name	displayName	string	Display Name

SchedulingGroupResponse

Scheduling Group Entity

Name	Path	Type	Description
ID	id	string	The unique ID of the scheduling group.
Display Name	displayName	string	The display name for the scheduling group.
Is Active	isActive	boolean	Indicates whether the scheduling group can be used when creating new entities or updating existing ones.
User IDs	userIds	array of string	List of IDs of users in the scheduling group.

AtMentionUser_V1

@mention Token

Name	Path	Type	Description
@mention	atMention	string	An @mention token for the user. This property can be inserted into messages and adaptive cards

AtMentionTagResponse

@mention token for a tag

Name	Path	Type	Description
@mention tag	atMention	string	A token for the tag to @mention. It can be inserted into messages and adaptive cards sent from a person

NewChatResponse

Response for new chat that was created

Name	Path	Type	Description
Conversation ID	id	string	The chat's unique identifier

NewMeetingRespone

Response for new meeting that was created

Name	Path	Type	Description
ID	id	string	Unique identifier for the event
Created timestamp	createdDateTime	string	Timestamp the event was created
Last modified timestamp	lastModifiedDateTime	string	Timestamp the event was last modified
Categories	categories	array of	The categories associated with the event
Time Zone	timeZone	string	Time zone of the event
Pre-event reminder time	reminderMinutesBeforeStart	integer	The number of minutes before the event start time that the reminder alert occurs
Reminders enabled	isReminderOn	boolean	Set to true if an alert is set to remind the user of the event
Has Attachments	hasAttachments	boolean	Set to true if the event has attachments
Subject	subject	string	The text of the event's subject line
Body preview	bodyPreview	string	The preview of the message associated with the event
Importance	importance	string	The importance of the event. The possible values are: low, normal, high
Sensitivity	sensitivity	string	Sensitivity of the event
Is all day	isAllDay	boolean	Set to true if the event lasts all day
Is cancelled	isCancelled	boolean	Set to true if the event has been canceled
Is organizer	isOrganizer	boolean	Set to true if the calendar owner is the organizer of the event
Response requested	responseRequested	boolean	The organizer would like an invitee to send a response to the event
Show As	showAs	string	The status to show. Possible values are: free, tentative, busy, oof, workingElsewhere, unknown.
Type	type	string	The event type. Possible values are: singleInstance, occurrence, exception, seriesMaster
Web last	webLink	string	The URL to open the event in Outlook on the web.
Online meeting URL	onlineMeetingUrl	string	A URL for an online meeting
Allow new time proposals	allowNewTimeProposals	boolean	True if the meeting organizer allows invitees to propose a new time when responding
Recurrence pattern	recurrence.pattern	object	The frequency of an event
Recurrence range	recurrence.range	object	The duration of an event
Response	responseStatus.response	string	The response type. Possible values are: none, organizer, tentativelyAccepted, accepted, declined, notResponded
Time	responseStatus.time	string	The date and time when the response was returned
Content type	body.contentType	string	The type of the content. Possible values are text and html
Event message content	body.content	string	The content of the event
date and time	start.dateTime	string	Start time of the event (example: '2017-08-29T04:00:00')
date and time	end.dateTime	string	End time of the event (example: '2017-08-29T04:00:00')
display name	location.displayName	string	The name associated with the location
Attendee	attendees	array of object	The collection of attendees for the event
type	attendees.type	string	The attendee type: required, optional, resource
response	attendees.status.response	string	The response type. Possible values are: none, organizer, tentativelyAccepted, accepted, declined, notResponded
time	attendees.status.time	string	The date and time when the response was returned
name	attendees.emailAddress.name	string	The display name of an attendee
address	attendees.emailAddress.address	string	The email address of an attendee
name	organizer.emailAddress.name	string	The display name of an organizer
address	organizer.emailAddress.address	string	The email address of an organizer
join url	onlineMeeting.joinUrl	string	The external link that launches the online meeting

LastModifiedBy

Last Modified By

Name	Path	Type	Description
Application	application	string	Application
Device	device	string	Device
Conversation	conversation	string	Conversation
Id	user.id	string	Id
Display Name	user.displayName	string	Display Name

MemberSettings

Settings to configure whether members can perform certain actions, for example, create channels and add bots, in the team

Name	Path	Type	Description
Members are allowed create/update channels	allowCreateUpdateChannels	boolean	If set to true, members can add and update channels
Members are allowed delete channels	allowDeleteChannels	boolean	If set to true, members can delete channels
Members are allowed add/remove apps	allowAddRemoveApps	boolean	If set to true, members can add and remove apps
Members are allowed create/update/remove tabs	allowCreateUpdateRemoveTabs	boolean	If set to true, members can add, update, and remove tabs
Members are allowed create/update/remove connectors	allowCreateUpdateRemoveConnectors	boolean	If set to true, members can add, update, and remove connectors

GuestSettings

Settings to configure whether guests can create, update, or delete channels in the team

Name	Path	Type	Description
Guests are allowed create/update channels	allowCreateUpdateChannels	boolean	If set to true, guests can add and update channels
Guests are allowed delete channels	allowDeleteChannels	boolean	If set to true, guests can delete channels

MessagingSettings

Settings to configure messaging and mentions in the team

Name	Path	Type	Description
Allow user to edit messages	allowUserEditMessages	boolean	If set to true, users can edit their messages
Allow user to delete messages	allowUserDeleteMessages	boolean	If set to true, users can delete their messages
Allow owner to delete messages	allowOwnerDeleteMessages	boolean	If set to true, owners can delete any message
Allow team mentions	allowTeamMentions	boolean	If set to true, @team mentions are allowed
Allow channel mentions	allowChannelMentions	boolean	If set to true, @channel mentions are allowed

FunSettings

Settings to configure use of Giphy, memes, and stickers in the team

Name	Path	Type	Description
Allow giphy	allowGiphy	boolean	If set to true, enables Giphy use
Giphy content rating	giphyContentRating	string	Giphy content rating. Possible values are: moderate, strict
Allow stickers and memes	allowStickersAndMemes	boolean	If set to true, enables users to include stickers and memes
Allow custom memes	allowCustomMemes	boolean	If set to true, enables users to include custom memes

DiscoverySettings

Settings to configure team discoverability by others.

Name	Path	Type	Description
Show in team's search and suggestions	showInTeamsSearchAndSuggestions	boolean	If set to true, the team is visible via search and suggestions from the Teams client

ObjectWithoutType