Microsoft Teams Component

Easily manage the teams, groups, channels, and messages associated with your Microsoft Teams account

Component key: ms-teams

Description

Microsoft Teams is a business communication platform developed by Microsoft, as part of the Microsoft 365 family of products. This component allows you to easily manage teams, groups, channels, and messages inside of your Microsoft Teams account.

Authorization Notes

The Microsoft Teams component uses OAuth 2.0 to authenticate against the Microsoft Graph API. To configure an OAuth 2.0 credential you must first create an application through Active Directory in the Microsoft Azure portal. For more information regarding authenticating against the Microsoft Graph API refer to the Microsoft docs.

Actions

Add Group Member

Add a member to an existing group | key: addGroupMember

Input	Key	Notes	Example
Group Id string / Required	groupId	Provide a string value for the group Id	37635f8e-82d1-example-8ba4-af6e8985427f
timeout string	timeout	The maximum time a client will await a response	3000
User Id string / Required	userId	Provide a string value for the Id of the user.	37635f8e-82d1-example-8ba4-af6e8985427f

Authorization

Authorization is required for this action.

Auth Type	Key	Description	Fields
OAuth 2.0 - Authorization Code	oauth2	OAuth 2.0 authorization using the authorization code grant type	Client ID |  client_id Client Secret |  client_secret Scopes |  scopes Authorization URL |  auth_uri Access Token URL |  token_uri

---

Add Group Owner

Add an owner (admin) to an existing group | key: addGroupOwner

Input	Key	Notes	Example
Group Id string / Required	groupId	Provide a string value for the group Id	37635f8e-82d1-example-8ba4-af6e8985427f
timeout string	timeout	The maximum time a client will await a response	3000
User Id string / Required	userId	Provide a string value for the Id of the user.	37635f8e-82d1-example-8ba4-af6e8985427f

Authorization

Authorization is required for this action.

Auth Type	Key	Description	Fields
OAuth 2.0 - Authorization Code	oauth2	OAuth 2.0 authorization using the authorization code grant type	Client ID |  client_id Client Secret |  client_secret Scopes |  scopes Authorization URL |  auth_uri Access Token URL |  token_uri

---

Add Team Member

Add a new member to the team | key: addMember

Input	Key	Notes	Example
Roles string	roles	For each item, provide a string value containing a role you would like to assign the user.	owner
Team Id string / Required	teamId	Provide a string value for the team Id	37635f8e-82d1-example-8ba4-af6e8985427f
timeout string	timeout	The maximum time a client will await a response	3000
User Id string / Required	userId	Provide a string value for the Id of the user.	37635f8e-82d1-example-8ba4-af6e8985427f

Authorization

Authorization is required for this action.

Auth Type	Key	Description	Fields
OAuth 2.0 - Authorization Code	oauth2	OAuth 2.0 authorization using the authorization code grant type	Client ID |  client_id Client Secret |  client_secret Scopes |  scopes Authorization URL |  auth_uri Access Token URL |  token_uri

---

Archive Team

Archive the specified team | key: archiveTeam

Input	Key	Notes	Example
Team Id string / Required	teamId	Provide a string value for the team Id	37635f8e-82d1-example-8ba4-af6e8985427f
timeout string	timeout	The maximum time a client will await a response	3000

Authorization

Authorization is required for this action.

Auth Type	Key	Description	Fields
OAuth 2.0 - Authorization Code	oauth2	OAuth 2.0 authorization using the authorization code grant type	Client ID |  client_id Client Secret |  client_secret Scopes |  scopes Authorization URL |  auth_uri Access Token URL |  token_uri

---

Create Channel

Create a channel inside a team | key: createChannel

Input	Key	Default	Notes	Example
Channel Description string / Required	channelDescription		Provide a string value for the channel description.	This is an example description
Channel Name string / Required	channelName		Provide a string value for the channel name.	myChannel
Membership Type string / Required	membershipType		The type of the channel. Can be set during creation and can't be changed. Possible values are: standard - Channel inherits the list of members of the parent team; private - Channel can have members that are a subset of all the members on the parent team.
Team Id string / Required	teamId		Provide a string value for the team Id	37635f8e-82d1-example-8ba4-af6e8985427f
timeout string	timeout		The maximum time a client will await a response	3000
Visibility string / Required	visibility	public	The visibility of the group and team. Defaults to Public.

Authorization

Authorization is required for this action.

Auth Type	Key	Description	Fields
OAuth 2.0 - Authorization Code	oauth2	OAuth 2.0 authorization using the authorization code grant type	Client ID |  client_id Client Secret |  client_secret Scopes |  scopes Authorization URL |  auth_uri Access Token URL |  token_uri

---

Create Team

Create a new team | key: createTeam

Input	Key	Default	Notes	Example
Allow users to create/update channels boolean	allowCreateUpdateChannels		This flag will give users the permission to create/update channels.
Allow Giphy boolean	allowGiphy		This flag will enable the use of Giphy content in your team.
Allow users to delete messages boolean	allowUserDeleteMessages		This flag will give users the permission to delete messages.
Allow users to edit messages boolean	allowUserEditMessages		This flag will give users the permission to edit messages.
Channel Description string / Required	channelDescription		Provide a string value for the channel description.	This is an example description
Channel Name string / Required	channelName		Provide a string value for the channel name.	myChannel
Giphy Content Rating string	giphyContentRating
Team Description string / Required	teamDescription		Provide a string value for the description.	This is an example description.
Team Name string / Required	teamName		Provide a string value for the team name.	myTeam
timeout string	timeout		The maximum time a client will await a response	3000
Visibility string / Required	visibility	public	The visibility of the group and team. Defaults to Public.

Authorization

Authorization is required for this action.

Auth Type	Key	Description	Fields
OAuth 2.0 - Authorization Code	oauth2	OAuth 2.0 authorization using the authorization code grant type	Client ID |  client_id Client Secret |  client_secret Scopes |  scopes Authorization URL |  auth_uri Access Token URL |  token_uri

---

Get Member

Get information or metadata about a team member | key: getMember

Input	Key	Notes	Example
Member Id string / Required	memberId	Provide a string value for the member Id	37635f8e-82d1-example-8ba4-af6e8985427f
Team Id string / Required	teamId	Provide a string value for the team Id	37635f8e-82d1-example-8ba4-af6e8985427f
timeout string	timeout	The maximum time a client will await a response	3000

Authorization

Authorization is required for this action.

Auth Type	Key	Description	Fields
OAuth 2.0 - Authorization Code	oauth2	OAuth 2.0 authorization using the authorization code grant type	Client ID |  client_id Client Secret |  client_secret Scopes |  scopes Authorization URL |  auth_uri Access Token URL |  token_uri

---

Get Team

Get information or metadata about a team by Id | key: getTeam

Input	Key	Notes	Example
Team Id string / Required	teamId	Provide a string value for the team Id	37635f8e-82d1-example-8ba4-af6e8985427f
timeout string	timeout	The maximum time a client will await a response	3000

Authorization

Authorization is required for this action.

Auth Type	Key	Description	Fields
OAuth 2.0 - Authorization Code	oauth2	OAuth 2.0 authorization using the authorization code grant type	Client ID |  client_id Client Secret |  client_secret Scopes |  scopes Authorization URL |  auth_uri Access Token URL |  token_uri

---

List Channel Messages

List all of the messages in a given channel | key: listChannelMessages

Input	Key	Notes	Example
Channel Id string / Required	channelId	Provide a string value for the channel Id	37635f8e-82d1-example-8ba4-af6e8985427f
Team Id string / Required	teamId	Provide a string value for the team Id	37635f8e-82d1-example-8ba4-af6e8985427f
timeout string	timeout	The maximum time a client will await a response	3000

Authorization

Authorization is required for this action.

Auth Type	Key	Description	Fields
OAuth 2.0 - Authorization Code	oauth2	OAuth 2.0 authorization using the authorization code grant type	Client ID |  client_id Client Secret |  client_secret Scopes |  scopes Authorization URL |  auth_uri Access Token URL |  token_uri

---

List Channels

Retrieve the list of channels in a given team | key: listChannels

Input	Key	Notes	Example
Team Id string / Required	teamId	Provide a string value for the team Id	37635f8e-82d1-example-8ba4-af6e8985427f
timeout string	timeout	The maximum time a client will await a response	3000

Authorization

Authorization is required for this action.

Auth Type	Key	Description	Fields
OAuth 2.0 - Authorization Code	oauth2	OAuth 2.0 authorization using the authorization code grant type	Client ID |  client_id Client Secret |  client_secret Scopes |  scopes Authorization URL |  auth_uri Access Token URL |  token_uri

---

List Groups

List the groups associated with your account | key: listGroups

Input	Key	Notes	Example
timeout string	timeout	The maximum time a client will await a response	3000

Authorization

Authorization is required for this action.

Auth Type	Key	Description	Fields
OAuth 2.0 - Authorization Code	oauth2	OAuth 2.0 authorization using the authorization code grant type	Client ID |  client_id Client Secret |  client_secret Scopes |  scopes Authorization URL |  auth_uri Access Token URL |  token_uri

---

list Team Members

List all the members in a team | key: listMembers

Input	Key	Notes	Example
Team Id string / Required	teamId	Provide a string value for the team Id	37635f8e-82d1-example-8ba4-af6e8985427f
timeout string	timeout	The maximum time a client will await a response	3000

Authorization

Authorization is required for this action.

Auth Type	Key	Description	Fields
OAuth 2.0 - Authorization Code	oauth2	OAuth 2.0 authorization using the authorization code grant type	Client ID |  client_id Client Secret |  client_secret Scopes |  scopes Authorization URL |  auth_uri Access Token URL |  token_uri

---

List Teams

List the teams associated with your account | key: listTeams

Input	Key	Notes	Example
timeout string	timeout	The maximum time a client will await a response	3000

Authorization

Authorization is required for this action.

Auth Type	Key	Description	Fields
OAuth 2.0 - Authorization Code	oauth2	OAuth 2.0 authorization using the authorization code grant type	Client ID |  client_id Client Secret |  client_secret Scopes |  scopes Authorization URL |  auth_uri Access Token URL |  token_uri

---

Remove Team Member

Remove a user from a provided team | key: removeMember

Input	Key	Notes	Example
Member Id string / Required	memberId	Provide a string value for the member Id	37635f8e-82d1-example-8ba4-af6e8985427f
Team Id string / Required	teamId	Provide a string value for the team Id	37635f8e-82d1-example-8ba4-af6e8985427f
timeout string	timeout	The maximum time a client will await a response	3000

Authorization

Authorization is required for this action.

Auth Type	Key	Description	Fields
OAuth 2.0 - Authorization Code	oauth2	OAuth 2.0 authorization using the authorization code grant type	Client ID |  client_id Client Secret |  client_secret Scopes |  scopes Authorization URL |  auth_uri Access Token URL |  token_uri

---

Send Message To Channel

Send a message to a given channel | key: sendChannelMessage

Input	Key	Notes	Example
Channel Id string / Required	channelId	Provide a string value for the channel Id	37635f8e-82d1-example-8ba4-af6e8985427f
Message string / Required	message	Provide a string value for the message to send.	Hello World!
Team Id string / Required	teamId	Provide a string value for the team Id	37635f8e-82d1-example-8ba4-af6e8985427f
timeout string	timeout	The maximum time a client will await a response	3000

Authorization

Authorization is required for this action.

Auth Type	Key	Description	Fields
OAuth 2.0 - Authorization Code	oauth2	OAuth 2.0 authorization using the authorization code grant type	Client ID |  client_id Client Secret |  client_secret Scopes |  scopes Authorization URL |  auth_uri Access Token URL |  token_uri

---

Update Team

Update an existing team | key: updateTeam

Input	Key	Default	Notes	Example
Allow users to create/update channels boolean	allowCreateUpdateChannels		This flag will give users the permission to create/update channels.
Allow Giphy boolean	allowGiphy		This flag will enable the use of Giphy content in your team.
Allow users to delete messages boolean	allowUserDeleteMessages		This flag will give users the permission to delete messages.
Allow users to edit messages boolean	allowUserEditMessages		This flag will give users the permission to edit messages.
Giphy Content Rating string	giphyContentRating
Team Description string / Required	teamDescription		Provide a string value for the description.	This is an example description.
Team Id string / Required	teamId		Provide a string value for the team Id	37635f8e-82d1-example-8ba4-af6e8985427f
Team Name string / Required	teamName		Provide a string value for the team name.	myTeam
timeout string	timeout		The maximum time a client will await a response	3000
Visibility string / Required	visibility	public	The visibility of the group and team. Defaults to Public.

Authorization

Authorization is required for this action.

Auth Type	Key	Description	Fields
OAuth 2.0 - Authorization Code	oauth2	OAuth 2.0 authorization using the authorization code grant type	Client ID |  client_id Client Secret |  client_secret Scopes |  scopes Authorization URL |  auth_uri Access Token URL |  token_uri

---