Collaboration & Communication

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_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_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_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