Microsoft Teams

Learn how to use Microsoft Teams with Composio

Overview

SLUG

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
bearer_token
string

Tools

SLUG: MICROSOFT_TEAMS_ADD_MEMBER_TO_TEAM

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
objectRequired
error
string
successful
booleanRequired

SLUG: MICROSOFT_TEAMS_ARCHIVE_TEAM

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
objectRequired
error
string
successful
booleanRequired

SLUG: MICROSOFT_TEAMS_CREATE_MEETING

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
objectRequired
error
string
successful
booleanRequired

SLUG: MICROSOFT_TEAMS_CREATE_TEAM

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
objectRequired
error
string
successful
booleanRequired

SLUG: MICROSOFT_TEAMS_DELETE_TEAM

Tool to delete a microsoft teams team. use after confirming the target team id.

Action Parameters

team_id
stringRequired

Action Response

data
objectRequired
error
string
successful
booleanRequired

SLUG: MICROSOFT_TEAMS_GET_CHANNEL

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
objectRequired
error
string
successful
booleanRequired

SLUG: MICROSOFT_TEAMS_GET_CHAT_MESSAGE

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
objectRequired
error
string
successful
booleanRequired

SLUG: MICROSOFT_TEAMS_GET_TEAM

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
objectRequired
error
string
successful
booleanRequired

SLUG: MICROSOFT_TEAMS_LIST_MESSAGE_REPLIES

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
objectRequired
error
string
successful
booleanRequired

SLUG: MICROSOFT_TEAMS_LIST_TEAM_MEMBERS

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
objectRequired
error
string
successful
booleanRequired

SLUG: MICROSOFT_TEAMS_TEAMS_CREATE_CHAT

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
Required
error
string
successful
booleanRequired

SLUG: MICROSOFT_TEAMS_UNARCHIVE_TEAM

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
objectRequired
error
string
successful
booleanRequired

SLUG: MICROSOFT_TEAMS_UPDATE_CHANNEL_MESSAGE

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
objectRequired
error
string
successful
booleanRequired

SLUG: MICROSOFT_TEAMS_UPDATE_CHAT_MESSAGE

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
objectRequired
error
string
successful
booleanRequired

SLUG: MICROSOFT_TEAMS_UPDATE_TEAM

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
objectRequired
error
string
successful
booleanRequired

SLUG: MICROSOFT_TEAMS_CHATS_GET_ALL_CHATS

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
objectRequired
error
string
successful
booleanRequired

SLUG: MICROSOFT_TEAMS_CHATS_GET_ALL_MESSAGES

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
objectRequired
error
string
successful
booleanRequired

SLUG: MICROSOFT_TEAMS_TEAMS_CREATE_CHANNEL

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
objectRequired
error
string
successful
booleanRequired

SLUG: MICROSOFT_TEAMS_TEAMS_GET_MESSAGE

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
objectRequired
error
string
successful
booleanRequired

SLUG: MICROSOFT_TEAMS_TEAMS_LIST

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
objectRequired
error
string
successful
booleanRequired

SLUG: MICROSOFT_TEAMS_TEAMS_LIST_CHANNELS

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
objectRequired
error
string
successful
booleanRequired

SLUG: MICROSOFT_TEAMS_TEAMS_LIST_CHAT_MESSAGES

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
objectRequired
error
string
successful
booleanRequired

SLUG: MICROSOFT_TEAMS_TEAMS_LIST_PEOPLE

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
objectRequired
error
string
successful
booleanRequired

SLUG: MICROSOFT_TEAMS_TEAMS_POST_CHANNEL_MESSAGE

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
objectRequired
error
string
successful
booleanRequired

SLUG: MICROSOFT_TEAMS_TEAMS_POST_CHAT_MESSAGE

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
objectRequired
error
string
successful
booleanRequired

SLUG: MICROSOFT_TEAMS_TEAMS_POST_MESSAGE_REPLY

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
objectRequired
error
string
successful
booleanRequired