Microsoft Teams API overview

Microsoft Teams is the ultimate hub for teamwork and intelligent communications. Built on the strength and scale of Microsoft 365 with over 120 million users, Microsoft Teams delivers chat-based collaboration, meetings, calling, and enterprise voice features.

Why integrate with Microsoft Teams?

Automate team lifecycles

Use Microsoft Graph to create a new virtual team when a new business issue arises, add the right people to the team, and configure the team with channels, tabs, and apps. If you want to get the new team together to discuss the business issue, add a new event to the team calendar.

Automate team lifecycles by creating a team, adding members and owners, configuring team settings, adding channels, installing apps, adding tabs, and archiving or deleting the team when the time comes.

When the business issue is resolved and you no longer need the team, use the Microsoft Teams API to archive or delete the team. If you know the maximum duration of the team when you create it, set an Microsoft 365 group expiration policy for the team that automatically removes the team according to the policy.

Get work done even when no one is around

Use application permissions to work with teams, channels, and tabs without human intervention. Create a new channel when your customer files an order. Automatically create teams for classes at the beginning of the school year, and archive them at the end.

Create teams linked to your app

Let customers create new teams and channels. Install your Teams app in the new teams. Pin your app to a tab in the new channel. Send messages to the channel linking back to your website.

Create and manage multiple teams and channels

Microsoft Graph makes it easy to create large numbers of teams and populate them with users and channels, by automating the creation and management of teams, channels, tabs, and apps. Microsoft Graph also lets you find and archive the teams you are no longer using. This is the same API that the Microsoft Teams Admin Center and Teams PowerShell cmdlets are built on.

Deploy apps to teams

List the teams in your tenant, and install apps to them. Create tabs in channels to give users easy access to apps.

Use Microsoft Graph in any kind of app

Microsoft Teams apps give work groups a new tool to make collaboration a more productive and compelling experience. These apps let work group users share assets, interact through chat, and schedule events on the team calendar. These apps can also automate creating teams, channels, and conversations, enhancing the value of Microsoft Teams.

You can create websites, services, and native platform applications that run outside the Microsoft Teams user experience, and call the Teams API to automate Teams scenarios.

Types of apps enabled for Microsoft Teams

Call the Microsoft Teams API from tabs, bots, websites, and services

These collaboration tools include Microsoft Graph-enabled tabs or bots running inside Microsoft Teams apps. You can also call Microsoft Graph outside of a Microsoft Teams app, such as from a website or a web service. If you've already enabled your website for Microsoft Graph, you can use that work for Microsoft Teams by using the Microsoft Teams developer platform to create a tab that uses the existing website code.

Microsoft Teams APIs can enhance apps inside and outside of Teams:

App type Scenario description
Tabs Surface your content in Microsoft Teams.
Bots Help users get tasks done in conversations.
Connectors Post updates from external services to channels.
Actionable messaging Add enhanced interaction to your connector cards.
Messaging extensions Allow users to query and share information in conversations.
Websites Surface enhanced content in your webpages.
Services Enhance your client applications with Microsoft Graph data via your web service.
Activity feed Engage users via feed notifications.
Calling and online meetings (preview) Create Microsoft Teams apps with bots that can initiate and participate in audio/video calls, route/transfer calls based on interactive voice response (IVR) flows, and participate in online meetings.

Get notified about changes

Microsoft Teams supports subscribing to changes (create, update, and delete) to messages in channels and chats to allow apps to get near-instant updates. For details about how to subscribe to changes, see Get change notifications for messages in channels and chats.

API reference

Looking for the API reference for this service?

See the Teams API in Microsoft Graph.

Next steps