Microsoft Teams (Preview)

Microsoft Teams (Preview)

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

Throttling Limits

Name Calls Renewal Period
API calls per connection 100 60 seconds
Frequency of trigger polls 1 120 seconds

Actions

Create a channel

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

Required Parameters

Team Id
string
Unique id of the Team.
Display Name
string
Name of the channel.

Optional Parameters

Description
string
More information about the channel.

Returns

Description
string
More information about the channel.
Display Name
string
Name of the channel.
Id
string
Unique id of the channel.

Get messages

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

Required Parameters

Team Id
string
Unique id of the Team.
Channel Id
string
Unique id of the channel.

Returns

List channels

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

Required Parameters

Team Id
string
Unique id of the Team.

Returns

Channel List
array of object
List of one or more channels for a specific Team.
Description
string
More information about the channel.
Name
string
Brief summary of the channel.
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.

Required Parameters

Team Id
string
Unique id of the Team.
Display Name
string
Name of the channel.

Optional Parameters

Description
string
More information about the channel.

Returns

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

Post message

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

Required Parameters

Team Id
string
Unique id of the Team.
Channel Id
string
Unique id of the channel.
Message
string
Body of the message.

Returns

Description
string
More information about the channel.
Display Name
string
Name of the channel.
Id
string
Unique id of the channel.

Triggers

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.

Required Parameters

Team Id
string
Unique id of the Team.
Channel Id
string
Unique id of the channel.

Returns

attachments
array of string
attachments
content
string
content
contentType
string
contentType
createdDateTime
date-time
createdDateTime
deleted
boolean
deleted
etag
string
etag
application
string
application
device
string
device
displayName
string
displayName
id
string
id
identityProvider
string
identityProvider
id
string
Unique id of the message.
importance
string
importance
lastModifiedDateTime
string
lastModifiedDateTime
locale
string
locale
mentions
array of string
mentions
messageType
string
messageType
reactions
array of string
reactions
replyToId
string
Id of the parent message of the thread
subject
string
Message subject line. Optional.
summary
string
Summary text of the message that could be used for push notifications and summary views or fall back views.

When a new channel message is added

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

Required Parameters

Team Id
string
Unique id of the Team.
Channel Id
string
Unique id of the channel.

Returns

attachments
array of string
attachments
content
string
content
contentType
string
contentType
createdDateTime
date-time
createdDateTime
deleted
boolean
deleted
etag
string
etag
application
string
application
device
string
device
displayName
string
displayName
id
string
id
identityProvider
string
identityProvider
id
string
Unique id of the message.
importance
string
importance
lastModifiedDateTime
string
lastModifiedDateTime
locale
string
locale
mentions
array of string
mentions
messageType
string
messageType
reactions
array of string
reactions
replyToId
string
Id of the parent message of the thread
subject
string
Message subject line. Optional.
summary
string
Summary text of the message that could be used for push notifications and summary views or fall back views.

Definitions

GetMessagesFromChannel_Response

@odata.context
string
@odata.context
@odata.count
integer
@odata.count
@odata.nextLink
string
@odata.nextLink
Message List
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.

application
string
application
attachments
array of string
attachments
content
string
content
contentType
string
contentType
createdDateTime
date-time
createdDateTime
deleted
boolean
deleted
device
string
device
displayName
string
displayName
etag
string
etag
id
string
id
id
string
Unique id of the message.
identityProvider
string
identityProvider
importance
string
importance
lastModifiedDateTime
string
lastModifiedDateTime
locale
string
locale
mentions
array of string
mentions
messageType
string
messageType
reactions
array of string
reactions
replyToId
string
Id of the parent message of the thread
subject
string
Message subject line. Optional.
summary
string
Summary text of the message that could be used for push notifications and summary views or fall back views.