Microsoft Teams (Preview)

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
Flow Standard All Flow regions
PowerApps Standard All PowerApps regions

Throttling Limits

Name Calls Renewal Period
API calls per connection10060 seconds
Frequency of trigger polls1120 seconds
Non-Get requests per connection3003600 seconds

Actions

Create a channel

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

Get messages

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

List channels

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

List teams

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

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

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

Post a message (V3)

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

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

Post a message as the Flow bot to a user

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

Post a reply to a message

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

Post a reply to a message (V2)

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

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

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

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

Shifts: Get Schedule details

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

Shifts: Get Shift

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

Shifts: Get team

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

Shifts: Get Time Off Reasons

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

Shifts: List all team shifts

This operation returns all shifts assigned to members of a team

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.

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

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

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

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 Teams channel ID

Subject
subject string

Subject of the message.

Message
content True html

Body of the message.

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 Teams channel ID

Message
content True html

Body of the message.

Post a message as the Flow bot to a channel

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

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

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 Teams channel ID

Message
messageId True integer

Add Teams 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 a reply to a message (V2)

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 Teams channel ID

Message
messageId True integer

Add Teams message ID

Subject
subject string

Subject of the message.

Reply
content True html

Body of the message.

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

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

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

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

Shifts: Get Schedule details

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 Shift

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

Properties associated with a shift.

Shifts: Get 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

Shifts: Get Time Off Reasons

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

Returns

The list of Time Off Reasons.

Time Off Reasons Response
GetTimeOffReasonsResponse

Shifts: List all team shifts

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)

Returns

The list of shifts for a team.

Shifts Response
GetShiftsResponse

Triggers

When a new channel message is added

This operation triggers when a new message is posted to a channel in a Team.

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 a new channel message is added

This operation triggers when a new message is posted to a channel in a Team.

Parameters

Name Key Required Type Description
Team
groupId True string

Add Team ID

Channel
channelId True string

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

Definitions

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
Time Off Reasons Array
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 Date 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

ShiftResponse

Properties associated with a shift.

Name Path Type Description
Shift ID
id string

The unique ID of the shift.

Shift Created Date Time
createdDateTime date-time

yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)

Shift 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

Draft version of the shift

GetShiftsResponse

The list of shifts for a team.

Name Path Type Description
Shifts
value array of object

The list of shifts.

Shift ID
value.id string

The unique ID of the shift.

Shift Created Date Time
value.createdDateTime date-time

yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)

Shift Modified Date Time
value.lastModifiedDateTime date-time

yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)

Assigned To User ID
value.userId string

Assigned To User ID

Scheduling Group ID
value.schedulingGroupId string

Scheduling Group ID

Last Modified By
value.lastModifiedBy LastModifiedBy

Last Modified By

Shared shift
value.sharedShift SharedShift

Shared version of the shift

Draft shift
value.draftShift DraftShift

Draft version of the shift

SharedShift

Shared version of the shift

Name Path Type Description
Display Name
displayName string

Display Name

Notes
notes string

Notes

Shift Start Time
startDateTime date-time

yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)

Shift End Time
endDateTime date-time

yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)

Notes
theme string

Notes

activities
activities Activities

DraftShift

Draft version of the shift

Name Path Type Description
Display Name
displayName string

Display Name

Notes
notes string

Notes

Shift Start Time
startDateTime date-time

yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)

Shift End Time
endDateTime date-time

yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)

Notes
theme string

Notes

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

Activities

Name Path Type Description
Is Paid
isPaid boolean

Is Paid

Shift Start Time
startDateTime date-time

yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)

Shift End Time
endDateTime date-time

yyyy-MM-ddTHH:mm:ss.fffZ (UTC format)

Code
code string

Code

Display Name
displayName string

Display Name

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 Create Update Channels

Allow Delete Channels
allowDeleteChannels boolean

Allow Delete Channels

Allow Add Remove Apps
allowAddRemoveApps boolean

Allow Add Remove Apps

Allow Create Update Remove Tabs
allowCreateUpdateRemoveTabs boolean

Allow Create Update Remove Tabs

Allow Create Update Remove Connectors
allowCreateUpdateRemoveConnectors boolean

Allow Create Update Remove Connectors

GuestSettings

Guest Settings Entity

Name Path Type Description
Allow Create Update Channels
allowCreateUpdateChannels boolean

Allow Create Update Channels

Allow Delete Channels
allowDeleteChannels boolean

Allow 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