Microsoft Teams tools
The 12 Microsoft Teams operations your product runs on your customer's account through Connect. All of them use the same endpoint, POST /api/tools/{tool}/execute.
- List teamsGETLists the teams the user is a direct member of, with id, displayName, description and isArchived. Use the id as team_id in the other tools.
- List channelsGETLists the channels of a team that the user can see, with id, displayName, description, membershipType and webUrl. Private and shared channels appear only to their members. Use the id as channel_id in the message tools.
- Create channelPOSTCreates a standard channel, open to every member of the team, and returns it with its id. Private and shared channels need a member list and are not supported here.
- List channel messagesGETLists the root messages of a channel, without their replies, 20 per page and ordered by the latest activity of each thread. Only the first page comes back: the @odata.nextLink of the response cannot be followed here. Read a thread with List channel message replies.
- Get channel messageGETReturns one root message of a channel, with its body, the sender in from, createdDateTime and webUrl. Its replies are not included.
- List channel message repliesGETLists the replies to a root message of a channel. The root message is not included: read it with Get channel message. Only the first page comes back.
- Send channel messagePOSTPosts a new message in a channel as the user and returns it with its id. Microsoft's terms forbid using Teams as a log, so send only messages that people will read.
- Reply to channel messagePOSTPosts a reply in the thread of a root message of a channel, as the user, and returns it with its id. Send only messages that people will read.
- List chatsGETLists the one-on-one, group and meeting chats of the user, with id, topic, chatType and webUrl. One-on-one chats have no topic: use List chat members to see who is in a chat. Only the first page comes back.
- List chat membersGETLists the people in a chat, with displayName, email and userId.
- List chat messagesGETLists the messages of a chat, the most recently modified first, with body, the sender in from and createdDateTime. Only the first page comes back.
- Send chat messagePOSTSends a message in an existing chat as the user and returns it with its id. A new chat cannot be started here, so the chat must come from List chats. Send only messages that people will read.
Toolkits in the same category
See all 100 toolkitsSee Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
