Microsoft Teams

Reference

Microsoft Teams enables you to get all your content, tools and conversations in the Team workspace with Office 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 - US Department of Defense (DoD)
Power Automate	Standard	All Power Automate regions except the following: - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD)
Power Apps	Standard	All Power Apps regions except the following: - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD)

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

When a new channel message is added trigger only fires when root messages are added in the channel. Replies to an existing channel message will not result in the trigger event firing.
When posting a message, the message has a size limit of approximately 28KB. This encompasses all HTML elements like text, images, links, tables, mentions and so on. If the message exceeds 28KB the action will fail with an error stating: "Request Entity too large"
When a new channel message is added and When I am mentioned in a channel message have a polling interval of 3 minutes.
When a new team member is added and When a new team member is removed have 15 minute polling intervals due a limitation of the underlying API that would cause the trigger to fire multiple times for the same event.
When a new team member is added and When a new team member is removed will not work on unified groups with hidden members.
Posting a message or adaptive card to a private channel currently is not supported.
Actions using the Flow bot requires that the Power Automate app be available and should be set to "allow" state in Teams admin center.
In order to use the Teams conector, one of the subscriptions here must be enabled.
For a selected message trigger requires that the Power Automate Actions app (App ID: 00001016-de05-492e-9106-4828fc8a8687) must not be blocked. Using an admin account, check that the app is enabled by going here.
Add a member to a team action does allow guest users to be set as owners of the team.
Posting message or card via Power Virtual Agents requires the recipient to have the bot installed in Microsoft Teams. Learn more about notifying user in Microsoft Teams with proactive message.
When keywords are mentioned trigger only supports individual words. The trigger will not fire for phrases that are more than one word long.
When keywords are mentioned trigger fires for all data related to a message. This includes the sender of the message and the text that includes the time the message was sent.
Create a Teams meeting action requires an Exchange Online Mailbox in order to select the time zone.
Actions that use the Power Automate bot are not supported in sovereign clouds (GCC, GCCH, DoD)
Create a chat action has a maximum of 20 users per chat.
A single message can only @mention up to 20 users and 20 tags.
Create a chat action does not support guest users.
You can only have one flow with "When a message is posted in any chat" trigger.

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	This operation adds a user to a tags.
Add a member to a team	This operation adds a member to a team.
Create a channel	This operation is used to create a new channel for a specific Team.
Create a chat	This operation creates a one on one or group chat
Create a tag for a team	This operation creates a tag.
Create a team	This operation a creates a new team.
Create a Teams meeting	Create a meeting with a link at the bottom of the invite to join the meeting online on Teams
Delete a member from a tag	This operation deletes a member from a tag.
Delete a tag	This operation deletes a tag.
Get a team	This operation returns details for a team using the team's unique ID.
Get an @mention token for a tag	This operation creates a token that can be inserted into a message or adaptive card sent as a user inS a channel to @mention a tag.
Get an @mention token for a user	This operation creates a token that can be inserted into a message or adaptive card to @mention a user.
Get message details	This operation 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	This operation retrieves a list of tags.
List channels	This operation retrieves a list of all the channels for a specific Team.
List chats	This operation retrieves a list of recent chats.
List teams	This operation retrieves a list of all the Teams (Office 365 Groups) you are a member of.
List the members for a tag	This operation lists the members for a tag.
Post a choice of options as the Flow bot to a user	Easily automate the process of sending a message to a Teams user that contains a set of options they must choose from before they respond.
Post a feed notification	This operation posts a feed notification.
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	This operation posts an adaptive card to a chat or a channel and waits for a response.
Post adaptive card in a chat or channel	This operation posts an adaptive card to a chat or a channel.
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 message in a chat or channel	This operation 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	This operation replies with a message in a channel.
Reply with adaptive card in a channel	This operation replies with an adaptive card to a channel.
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.~~

Add a member to a tag

Operation ID:: AddMemberToTag

This operation adds a user to a tags.

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Add team ID
Tag ID	tagId	True	string	Add tag ID
User ID	userId	True	string	The user ID of the member to add to the tag.

Returns

Body: AddMemberToTagResponseSchema

Add a member to a team

Operation ID:: AddMemberToTeam

This operation adds a member to a team.

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Add team ID
A user AAD ID for the user to add to a team	userId	True	string	User AAD ID to add
Should the newly added user be an owner of the team	owner		boolean	The new member should be an owner

Create a channel

Operation ID:: CreateChannel

This operation is used to create a new channel for a specific Team.

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Add team ID
Description	description		string	More information about the channel.
Display Name	displayName	True	string	Name of the channel.

Returns

Name	Path	Type	Description
Description	description	string	More information about the channel.
Display Name	displayName	string	Name of the channel.
Id	id	string	Unique ID of the channel.

Create a chat

Operation ID:: CreateChat

This operation creates a one on one or group chat

Parameters

Name	Key	Required	Type	Description
Title	topic		string	Enter title (displays in group chats, not 1:1 chats)
Members to add	members	True	string	Enter user ID 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

This operation creates a tag.

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Add team ID
Display Name	displayName	True	string	The display name for the tag.
User IDs	members	True	string	List of users separated by semi-colons to add to the tag.

Returns

The created tag for a team.

Tag: CreateTagResponseSchema

Create a team

Operation ID:: CreateATeam

This operation a creates a new team.

Parameters

Name	Key	Required	Type	Description
Team Name	displayName	True	string	Name of the team
Description	description	True	string	Description of 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 Teams

Parameters

Name	Key	Required	Type	Description
Calendar id	calendarid	True	string	Select a Value
Subject	subject	True	string	Event subject
Message	content	True	string	Body of the message.
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
Location	displayName		string	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
Number of recurrences	interval		integer	Number of recurrences. Required when meeting is a recurrence
Recurrence Day(s) of week	Days of week		string	Days of week (example: 'Monday'). Required when recurrence pattern is NOT daily
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
Is all day event?	isAllDay		boolean	Set to true if the event lasts all day
Reminder	reminderMinutesBeforeStart		integer	Time in minutes before event start to remind
Is reminder on	isReminderOn		boolean	Set to true if an alert is set to remind the user of the event.
Show as	showAs		string	Status to show during the event.
Response Requested	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

This operation deletes a member from a tag.

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Add team ID
Tag ID	tagId	True	string	Add tag ID
Tag Member ID	tagMemberId	True	string	Add tag member Id

Delete a tag

Operation ID:: DeleteTag

This operation deletes a tag.

Parameters

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

Get a team

Operation ID:: GetTeam

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

Parameters

Name	Key	Required	Type	Description
Team	teamId	True	string	Add team ID

Returns

Get team response

Body: GetTeamResponse

Get an @mention token for a tag

Operation ID:: AtMentionTag

This operation creates a token that can be inserted into a message or adaptive card sent as a user inS a channel to @mention a tag.

Parameters

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

Returns

@mention token for a tag

Body: AtMentionTagResponse

Get an @mention token for a user

Operation ID:: AtMentionUser

This operation 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

This operation gets details of a message in a chat or a channel.

Parameters

Name	Key	Required	Type	Description
Message	messageId	True	string	Add 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	Add team ID
Channel	channelId	True	string	Add channel ID

Returns

Body: GetMessagesFromChannel_Response

List all tags for a team

Operation ID:: GetTags

This operation retrieves a list of tags.

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Add team ID

Returns

Body: GetTagsResponseSchema

List channels

Operation ID:: GetChannelsForGroup

This operation retrieves a list of all the channels for a specific Team.

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Add team ID

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	More information about the channel.
Name	value.displayName	string	Brief summary of the channel.
Id	value.id	string	Unique ID of the channel.

List chats

Operation ID:: GetChats

This operation retrieves a list of recent chats.

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	The name of the chat.
Created Date Time	value.createdDateTime	date-time	The date and time that the chat was created.
Last Updated Date Time	value.lastUpdatedDateTime	date-time	The date and time that the chat was last updated.
Conversation Id	value.id	string	Unique conversation ID of chat.

List teams

Operation ID:: GetAllTeams

This operation retrieves a list of all the Teams (Office 365 Groups) you are a member of.

Returns

Name	Path	Type	Description
Teams List	value	array of object	List of one or more Teams you are a part of.
Description	value.description	string	More information about the Team.
Name	value.displayName	string	Brief summary of the Team.
Id	value.id	string	Unique ID of the Team (O365 group).

List the members for a tag

Operation ID:: GetTagMembers

This operation lists the members for a tag.

Parameters

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

Returns

Body: GetTagMembersResponseSchema

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

Operation ID:: SubscribeUserMessageWithOptions

Easily automate the process of sending a message to a Teams user that contains a set of options they must choose from before they respond.

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

This operation posts a feed notification.

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	Add team ID
Channel	channelId	True	string	Add 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	Add team ID
Channel	channelId	True	string	Add 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	Add team ID
Channel	channelId	True	string	Add 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	Add team ID
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	Add team ID
Channel	channelId	True	string	Add channel ID
Message	messageId	True	string	Add 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	Add team ID
Channel	channelId	True	string	Add channel ID
Message	messageId	True	string	Add 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

This operation posts an adaptive card to a chat or a channel and waits for a response.

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 adaptive card in a chat or channel

Operation ID:: PostCardToConversation

This operation posts an adaptive 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 adaptive card request	body	True	dynamic	The post adaptive card 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	Add team ID
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 message in a chat or channel

Operation ID:: PostMessageToConversation

This operation 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

The outputs of this operation are dynamic.

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	Add team ID
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

This operation replies with a message in a channel.

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 adaptive card in a channel

Operation ID:: ReplyWithCardToConversation

This operation replies with an adaptive card to a channel.

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

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	Add team ID
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	Add team ID
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	Add team ID
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	Add team ID
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	Add team ID
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	Add team ID
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	Add team ID
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	Add team ID
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	Add team ID
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	Add team ID
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	Add team ID
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	Add team ID

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	Add team ID
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	Add team ID
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	Add team ID
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	Add team ID
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	Add team ID
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	Add team ID
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	Add team ID
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	Add team ID
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	Add team ID
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	Add team ID
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	Add team ID
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	Add team ID
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

Triggers

For a selected message	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	This operation 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	This operation triggers when a new message is posted in any chat the user is a part of.
When a new team member is added	This operation triggers when a member is added to the given team.
When a new team member is removed	This operation triggers when a member is removed from the given team.
When I'm @mentioned	Creates a webhook for @mentions in chats or channels.
When I am mentioned in a channel message	This operation triggers when a new message is added to a channel in a Team, that mentions the current user.
When keywords are mentioned	Creates a webhook for keyword mentions in chats or channels.
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

Operation ID:: OnMessageSelected

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

Returns

The outputs of this operation are dynamic.

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.)

Returns

The outputs of this operation are dynamic.

When a new channel message is added

Operation ID:: OnNewChannelMessage

This operation 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	Add team ID
Channel	channelId	True	string	Add channel ID

Returns

Name	Path	Type	Description
attachments	attachments	array of object	attachments
items	attachments	object
content	body.content	string	content
contentType	body.contentType	string	contentType
createdDateTime	createdDateTime	date-time	createdDateTime
deleted	deleted	boolean	deleted
etag	etag	string	etag
application	from.application	object	application
device	from.device	string	device
displayName	from.user.displayName	string	displayName
id	from.user.id	string	ID
identityProvider	from.user.identityProvider	string	identityProvider
id	id	string	Unique ID of the message.
importance	importance	string	importance
lastModifiedDateTime	lastModifiedDateTime	string	lastModifiedDateTime
locale	locale	string	locale
mentions	mentions	array of object	mentions
items	mentions	object
messageType	messageType	string	messageType
reactions	reactions	array of object	reactions
items	reactions	object
replyToId	replyToId	string	ID of the parent message of the thread
subject	subject	string	Message subject line. 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

This operation 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

This operation triggers when a member is added to the given team.

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Add team ID

Returns

Name	Path	Type	Description
User Id	id	string	Unique id of the user.

When a new team member is removed

Operation ID:: OnGroupMembershipRemoval

This operation triggers when a member is removed from the given team.

Parameters

Name	Key	Required	Type	Description
Team	groupId	True	string	Add team ID

Returns

Name	Path	Type	Description
User Id	id	string	Unique id of the user.

When I'm @mentioned

Operation ID:: WebhookAtMentionTrigger

Creates a webhook for @mentions in chats or channels.

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

This operation triggers when a new message is added to a channel in a Team, that mentions the current user.

Parameters

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

Returns

Name	Path	Type	Description
attachments	attachments	array of object	attachments
items	attachments	object
content	body.content	string	content
contentType	body.contentType	string	contentType
createdDateTime	createdDateTime	date-time	createdDateTime
deleted	deleted	boolean	deleted
etag	etag	string	etag
application	from.application	object	application
device	from.device	string	device
displayName	from.user.displayName	string	displayName
id	from.user.id	string	ID
identityProvider	from.user.identityProvider	string	identityProvider
id	id	string	Unique ID of the message.
importance	importance	string	importance
lastModifiedDateTime	lastModifiedDateTime	string	lastModifiedDateTime
locale	locale	string	locale
mentions	mentions	array of object	mentions
items	mentions	object
messageType	messageType	string	messageType
reactions	reactions	array of object	reactions
items	reactions	object
replyToId	replyToId	string	ID of the parent message of the thread
subject	subject	string	Message subject line. 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

Creates a webhook for keyword mentions in chats or channels.

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 ID of the tag.
Team Id	value.teamId	string	The Team ID associated with the tag.
Name	value.displayName	string	The display name.
Member Count	value.memberCount	integer	The member count.

GetTagMembersResponseSchema

Name	Path	Type	Description
value	value	array of object
Tag Member Id	value.id	string	Unique ID of the tag member.
Tenant Id	value.tenantId	string	The tenant ID associated with the tag.
User Display Name	value.displayName	string	The user display name.
User Id	value.userId	string	The user ID.

CreateTagResponseSchema

The created tag for a team.

Name	Path	Type	Description
Id	id	string	Unique ID of the tag.
Team Id	teamId	string	The Team ID associated with the tag.
Name	displayName	string	The display name.
Member Count	memberCount	integer	The member count.

AddMemberToTagResponseSchema

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

ChatMessageWebhookResponseSchema

Message details

Name	Path	Type	Description
Message	value	array of object	Message details response
Conversation Id	value.conversationId	string	Conversation Id
ID	value.messageId	string	Message ID
Link	value.linkToMessage	string	Message link

MessageId

Name	Path	Type	Description
Message Id	id	string	Unique Message Id

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	content
contentType	body.contentType	string	contentType
createdDateTime	createdDateTime	date-time	createdDateTime
deleted	deleted	boolean	deleted
etag	etag	string	etag
application	from.application	object	application
device	from.device	string	device
displayName	from.user.displayName	string	displayName
id	from.user.id	string	ID
identityProvider	from.user.identityProvider	string	identityProvider
id	id	string	Unique ID of the message.
importance	importance	string	importance
lastModifiedDateTime	lastModifiedDateTime	string	lastModifiedDateTime
locale	locale	string	locale
mentions	mentions	array of object	mentions
items	mentions	object
messageType	messageType	string	messageType
reactions	reactions	array of object	reactions
items	reactions	object
replyToId	replyToId	string	ID of the parent message of the thread
subject	subject	string	Message subject line. 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 ID of the team.
Display Name	displayName	string	The name of the team.
Description of team	description	string	The description of the Team.
Internal Id	internalId	string	The Internal Id of the Team.
Web Url of team	webUrl	string	The Web Url of the Team.
Is Archived	isArchived	boolean	Is Archived
memberSettings	memberSettings	MemberSettings	Member Settings Entity
guestSettings	guestSettings	GuestSettings	Guest Settings Entity
messagingSettings	messagingSettings	MessagingSettings	Messaging Settings Entity
funSettings	funSettings	FunSettings	Guest Settings Entity
discoverySettings	discoverySettings	DiscoverySettings	Guest Settings Entity

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

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	Unique conversation Id

NewMeetingRespone

Response for new meeting that was created

Name	Path	Type	Description
id	id	string	Id
createdDateTime	createdDateTime	string	Created DateTime
lastModifiedDateTime	lastModifiedDateTime	string	Last Modified DateTime
categories	categories	array of	Categories
timeZone	timeZone	string	Time Zone
reminderMinutesBeforeStart	reminderMinutesBeforeStart	integer	Reminder Minutes Before Start
isReminderOn	isReminderOn	boolean	Is Reminder On
hasAttachments	hasAttachments	boolean	Has Attachments
subject	subject	string	Subject
bodyPreview	bodyPreview	string	Body Preview
importance	importance	string	Importance
sensitivity	sensitivity	string	Sensitivity
isAllDay	isAllDay	boolean	Is All Day
isCancelled	isCancelled	boolean	Is Cancelled
isOrganizer	isOrganizer	boolean	Is Organizer
responseRequested	responseRequested	boolean	Response Requested
showAs	showAs	string	Show As
type	type	string	Type
webLink	webLink	string	Web Link
onlineMeetingUrl	onlineMeetingUrl	string	Online Meeting Url
allowNewTimeProposals	allowNewTimeProposals	boolean	Allow New Time Proposals
pattern	recurrence.pattern	object	Recurrence Pattern
range	recurrence.range	object	Recurrence Range
response	responseStatus.response	string	Response
time	responseStatus.time	string	Time
contentType	body.contentType	string	Content Type
content	body.content	string	Content
dateTime	start.dateTime	string	DateTime
dateTime	end.dateTime	string	DateTime
displayName	location.displayName	string	Display Name
attendees	attendees	array of object	Attendees
type	attendees.type	string	Type
response	attendees.status.response	string	Response
time	attendees.status.time	string	Time
name	attendees.emailAddress.name	string	Name
address	attendees.emailAddress.address	string	Address
name	organizer.emailAddress.name	string	Name
address	organizer.emailAddress.address	string	Address
joinUrl	onlineMeeting.joinUrl	string	Join Url

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

Member Settings Entity

Name	Path	Type	Description
Allow Create Update Channels	allowCreateUpdateChannels	boolean	Allow to create and update channels
Allow Delete Channels	allowDeleteChannels	boolean	Allow to delete channels
Allow Add Remove Apps	allowAddRemoveApps	boolean	Allow to add and remove apps
Allow Create Update Remove Tabs	allowCreateUpdateRemoveTabs	boolean	Allow to create, update and remove tabs
Allow Create Update Remove Connectors	allowCreateUpdateRemoveConnectors	boolean	Allow to create, update and remove connectors

GuestSettings

Guest Settings Entity

Name	Path	Type	Description
Allow Create Update Channels	allowCreateUpdateChannels	boolean	Allow to create and update channels
Allow Delete Channels	allowDeleteChannels	boolean	Allow to delete channels

MessagingSettings

Messaging Settings Entity

Name	Path	Type	Description
Allow User Edit Messages	allowUserEditMessages	boolean	Allow User Edit Messages
Allow User Delete Messages	allowUserDeleteMessages	boolean	Allow User Delete Messages
Allow Owner Delete Messages	allowOwnerDeleteMessages	boolean	Allow Owner Delete Messages
Allow Team Mentions	allowTeamMentions	boolean	Allow Team Mentions
Allow Channel Mentions	allowChannelMentions	boolean	Allow Channel Mentions

FunSettings

Guest Settings Entity

Name	Path	Type	Description
Allow Giphy	allowGiphy	boolean	Allow Giphy
Giphy Content Rating	giphyContentRating	string	Giphy Content Rating
Allow Stickers And Memes	allowStickersAndMemes	boolean	Allow Stickers And Memes
Allow Custom Memes	allowCustomMemes	boolean	Allow Custom Memes

DiscoverySettings

Guest Settings Entity

Name	Path	Type	Description
Show In Teams Search And Suggestions	showInTeamsSearchAndSuggestions	boolean	Show In Teams Search And Suggestions

Microsoft Teams

Is this page helpful?

Known issues and limitations

Creating a connection

Microsoft Teams Credentials (Teams GCC High)

Microsoft Teams Credentials (Teams Public/Teams GCC)

Default

Throttling Limits

Actions

Add a member to a tag

Parameters

Returns

Add a member to a team

Parameters

Create a channel

Parameters

Returns

Create a chat

Parameters

Returns

Create a tag for a team

Parameters

Returns

Create a team

Parameters

Returns

Create a Teams meeting

Parameters

Returns

Delete a member from a tag

Parameters

Delete a tag

Parameters

Get a team

Parameters

Returns

Get an @mention token for a tag

Parameters

Returns

Get an @mention token for a user

Parameters

Returns

Get message details

Parameters

Returns

Get messages

Parameters

Returns

List all tags for a team

Parameters

Returns

List channels

Parameters

Returns

List chats

Parameters

Returns

List teams

Returns

List the members for a tag

Parameters

Returns

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

Parameters

Returns

Post a feed notification

Parameters

Post a message (V2) [DEPRECATED]

Parameters

Post a message (V3) [DEPRECATED]

Parameters

Returns

Post a message [DEPRECATED]

Parameters

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

Parameters

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

Parameters

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

Parameters