Microsoft Teams

Learn how to use Microsoft Teams with Composio

Overview

Enum

MICROSOFT_TEAMS

Description

Microsoft Teams integrates chat, video meetings, and file storage within Microsoft 365, providing virtual collaboration and communication for distributed teams

Authentication Details

client_id
stringRequired
client_secret
stringRequired
oauth_redirect_uri
stringDefaults to https://backend.composio.dev/api/v1/auth-apps/add
scopes
stringDefaults to Channel.Create,Channel.ReadBasic.All,ChannelMessage.Read.All,ChannelMessage.ReadWrite,ChannelMessage.Send,ChannelSettings.ReadWrite.All,Chat.Create,Chat.Read,Chat.ReadBasic,Chat.ReadWrite,Chat.ReadWrite.All,ChatMessage.Read,ChatMessage.Send,Directory.ReadWrite.All,Group.ReadWrite.All,offline_access,People.Read.All,Presence.ReadWrite,Team.Create,Team.ReadBasic.All,TeamMember.ReadWrite.All,TeamsActivity.Read,TeamsActivity.Send,User.Read,OnlineMeetings.ReadWrite

Actions

Tool to add a user to a microsoft teams team. use when granting or updating membership for a user.

Action Parameters

roles
array
team_id
stringRequired
user_id
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool to archive a microsoft teams team. use after confirming the team id; returns 202 if accepted.

Action Parameters

should_set_spo_site_read_only_for_members
boolean
team_id
stringRequired

Action Response

data
object
error
string
successful
boolean
Use to schedule a new standalone microsoft teams online meeting, i.e., one not linked to any calendar event.

Action Parameters

end_date_time
stringRequired
is_passcode_required
boolean
participants
array
start_date_time
stringRequired
subject
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool to create a new microsoft teams team. use when you need to provision a team with optional template, channels, and members.

Action Parameters

description
string
displayName
stringRequired
firstChannelName
string
members
array
template@odata.bind
string
visibility
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool to delete a microsoft teams team. use after confirming the target team id.

Action Parameters

team_id
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool to get a specific channel in a team. use after obtaining valid team and channel ids to fetch channel details.

Action Parameters

channel_id
stringRequired
team_id
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool to get a specific chat message. use after confirming chat id and message id.

Action Parameters

chat_id
stringRequired
message_id
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool to get a specific team. use when full details of one team by id are needed.

Action Parameters

team_id
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool to list replies to a channel message. use after obtaining team, channel, and message ids.

Action Parameters

channel_id
stringRequired
message_id
stringRequired
team_id
stringRequired
top
integerDefaults to 50

Action Response

data
object
error
string
successful
boolean
Tool to list members of a microsoft teams team. use when you need to retrieve the members of a specific team, for auditing or notifications.

Action Parameters

team_id
stringRequired
top
integer

Action Response

data
object
error
string
successful
boolean
Creates a new chat; if a 'oneonone' chat with the specified members already exists, its details are returned, while 'group' chats are always newly created.

Action Parameters

chatType
stringRequired
members
arrayRequired
topic
string

Action Response

data
error
string
successful
boolean
Tool to unarchive a microsoft teams team. use when you need to restore an archived team to active state.

Action Parameters

team_id
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool to update a message in a channel. use when you need to modify an existing channel message after confirming channel and message ids.

Action Parameters

channel_id
stringRequired
content
stringRequired
content_type
stringDefaults to text
message_id
stringRequired
team_id
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool to update a specific message in a chat. use when you need to correct or modify a sent chat message.

Action Parameters

chat_id
stringRequired
content
stringRequired
content_type
stringDefaults to text
message_id
stringRequired

Action Response

data
object
error
string
successful
boolean
Tool to update the properties of a team. use when you need to modify team settings such as member, messaging, or fun settings.

Action Parameters

funSettings
object
memberSettings
object
messagingSettings
object
team_id
stringRequired

Action Response

data
object
error
string
successful
boolean
Retrieves all microsoft teams chats a specified user is part of, supporting filtering, property selection, and pagination.

Action Parameters

filter
string
select
array
top
integerDefaults to 50
user_id
stringDefaults to me

Action Response

data
object
error
string
successful
boolean
Retrieves all messages from a specified microsoft teams chat using the microsoft graph api, automatically handling pagination; ensure `chat id` is valid and odata expressions in `filter` or `select` are correct.

Action Parameters

chat_id
stringRequired
filter
string
select
array
top
integerDefaults to 50

Action Response

data
object
error
string
successful
boolean
Creates a new 'standard', 'private', or 'shared' channel within a specified microsoft teams team.

Action Parameters

description
string
membership_type
stringDefaults to standard
name
stringRequired
team_id
stringRequired

Action Response

data
object
error
string
successful
boolean
Retrieves a specific message from a microsoft teams channel using its team, channel, and message ids.

Action Parameters

channel_id
stringRequired
message_id
stringRequired
team_id
stringRequired

Action Response

data
object
error
string
successful
boolean
Retrieves microsoft teams accessible by the authenticated user, allowing filtering, property selection, and pagination.

Action Parameters

filter
string
select
string
top
integerDefaults to 100

Action Response

data
object
error
string
successful
boolean
Retrieves channels for a specified microsoft teams team id (must be valid and for an existing team), with options to include shared channels, filter results, and select properties.

Action Parameters

filter
string
include_shared_channels
boolean
select
string
team_id
stringRequired

Action Response

data
object
error
string
successful
boolean
Retrieves messages (newest first) from an existing and accessible microsoft teams one-on-one chat, group chat, or channel thread, specified by `chat id`.

Action Parameters

chat_id
stringRequired
top
integerDefaults to 50

Action Response

data
object
error
string
successful
boolean
Retrieves a list of people relevant to a specified user from microsoft graph, noting the `search` parameter is only effective if `user id` is 'me'.

Action Parameters

filter
string
orderby
string
search
string
select
string
skip
integer
top
integer
user_id
stringDefaults to me

Action Response

data
object
error
string
successful
boolean
Posts a new text or html message to a specified channel in a microsoft teams team.

Action Parameters

channel_id
stringRequired
content
stringRequired
content_type
stringDefaults to text
team_id
stringRequired

Action Response

data
object
error
string
successful
boolean
Sends a non-empty message (text or html) to a specified, existing microsoft teams chat; content must be valid html if `content type` is 'html'.

Action Parameters

chat_id
stringRequired
content
stringRequired
content_type
stringDefaults to text

Action Response

data
object
error
string
successful
boolean
Sends a reply to an existing message, identified by `message id`, within a specific `channel id` of a given `team id` in microsoft teams.

Action Parameters

channel_id
stringRequired
content
stringRequired
content_type
stringDefaults to text
message_id
stringRequired
team_id
stringRequired

Action Response

data
object
error
string
successful
boolean