Microsoft Teams

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

Log in with Microsoft Teams Credentials (Teams GCC High).

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

Log in with Microsoft Teams Credentials (Teams Public/Teams GCC).

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

Log in with your credentials.

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 members

This operation list members based on a threadtype (chat, channel, etc).

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

This operation posts a card to a chat or a channel.

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.

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

This operation updates an existing adaptive card.

Add a member to a tag

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

Add a member to a team

This operation adds a member to a team.

Parameters

Name Key Required Type Description
Team
teamId True string

Add team ID

A user principal name or Microsoft Entra ID ID to add to a team
userId True string

User principal name or Microsoft Entra ID 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

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

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

Create a tag for a team

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.

Create a team

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

Create a Teams meeting

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

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

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

Delete a member from a tag

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

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

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

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.

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

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.

Parameters

Name Key Required Type Description
User
userId True string

Specify a user principal or user ID to @mention

Returns

@mention Token

Get message details

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

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

List all tags for a team

This operation retrieves a list of tags.

Parameters

Name Key Required Type Description
Team
groupId True string

Add team ID

Returns

List channels

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

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 members

This operation list members based on a threadtype (chat, channel, etc).

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

List teams

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

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

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.

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

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]

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]

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]

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]

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]

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]

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]

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

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

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]

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

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

Post message in a chat or channel

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

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.

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]

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

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

Reply with adaptive card in a channel

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

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.

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

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.

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]

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]

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]

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]

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]

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]

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]

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]

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]

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]

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]

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

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.

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]

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

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.

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]

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]

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]

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]

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]

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]

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]

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]

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]

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

Update an adaptive card in a chat or channel

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

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 (V2)

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

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 Description
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

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

This operation triggers when a new message is posted in any chat the user is a part of.

Returns

Message details

When a new team member is added

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

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

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

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

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

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.

ListMembersResponseSchema

List members response schema

Name Path Type Description
List of members
value array of object

List members response

displayName
value.displayName string

Display Name of the member

email
value.email string

Email Address of the member

ID
value.id string

ID of the member

roles
value.roles array of string

List of roles of the member

Tenant Id
value.tenantId string

Tenant Id of the member

User Id
value.userId string

User Id of the member

Conversation Start Time
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

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

Conversation Id
conversationId string

The conversation Id

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

ObjectWithoutType