Connectors Reference

Microsoft Teams

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

 

Status: Preview

Tier: Standard

Version: 1.0.0

 

Actions:

Name

Summary

GetAllTeams ()

List teams

GetChannelsForGroup (string groupId)

List channels

CreateChannel (string groupId, CreateChannelParameterBody body)

Create a channel

PostMessageToChannel (string groupId, string channelId, PostMessageToChannelParameterBody body)

Post message

 

Triggers:

Name

Summary

 

Objects:

Name

Summary

CreateChannelParameterBody

 

CreateChannelResponse

 

GetAllTeamsResponse

 

GetChannelsForGroupResponse

 

PostMessageToChannelParameterBody

 

 

Actions:

GetAllTeams

Summary: List teams

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

 

Syntax:

MicrosoftTeams.GetAllTeams ()

 

Returns:

          Type:GetAllTeamsResponse

 

GetChannelsForGroup

Summary: List channels

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

 

Syntax:

MicrosoftTeams.GetChannelsForGroup (string groupId)

 

Parameters:

Name

Type

Summary

Required

Related Action

groupId

string

(Team Id)

Unique id of the Team.

True

GetAllTeams

 

Returns:

          Type:GetChannelsForGroupResponse

 

CreateChannel

Summary: Create a channel

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

 

Syntax:

MicrosoftTeams.CreateChannel (string groupId, CreateChannelParameterBody body)

 

Parameters:

Name

Type

Summary

Required

Related Action

groupId

string

(Team Id)

Unique id of the Team.

True

GetAllTeams

body

CreateChannelParameterBody

 

 

True

 

Returns:

          Type:CreateChannelResponse

 

PostMessageToChannel

Summary: Post message

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

 

Syntax:

MicrosoftTeams.PostMessageToChannel (string groupId, string channelId, PostMessageToChannelParameterBody body)

 

Parameters:

Name

Type

Summary

Required

Related Action

groupId

string

(Team Id)

Unique id of the Team.

True

GetAllTeams

channelId

string

(Channel Id)

Unique id of the channel.

True

GetChannelsForGroup

body

PostMessageToChannelParameterBody

 

 

True

 

Returns:

 


 

CreateChannelParameterBody

Summary:

Description:

 

          Properties:

Name

Type

Summary

description

string

Description

More information about the channel.

displayName

string

Display Name

Name of the channel.


 

CreateChannelResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary

description

string

Description

More information about the channel.

displayName

string

Display Name

Name of the channel.

id

string

Id

Unique id of the channel.


 

GetAllTeamsResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary

@odata.context

string

 

 

value

array of (ValueItem)

Teams List

List of one or more Teams you are a part of.

 

ValueItem

Summary: Team

Description: Properties associated with a Team.

 

          Properties:

Name

Type

Summary

description

string

Description

More information about the Team.

displayName

string

Name

Brief summary of the Team.

id

string

Id

Unique id of the Team (O365 group).

 


 

GetChannelsForGroupResponse

Summary:

Description:

 

          Properties:

Name

Type

Summary

@odata.context

string

 

 

value

array of (ValueItem)

Channel List

List of one or more channels for a specific Team.

 

ValueItem

Summary: Channel

Description: Properties associated with a single channel.

 

          Properties:

Name

Type

Summary

description

string

Description

More information about the channel.

displayName

string

Name

Brief summary of the channel.

id

string

Id

Unique id of the channel.

 


 

PostMessageToChannelParameterBody

Summary:

Description:

 

          Properties:

Name

Type

Summary

rootMessage

RootMessage

 

rootMessage

 

RootMessage

Summary:

Description: rootMessage

 

          Properties:

Name

Type

Summary

body

Body

 

body

 

Body

Summary:

Description: body

 

          Properties:

Name

Type

Summary

content

string

Message

Body of the message.

contentType

integer(int32)

Type

0 for text or 1 for html.