Microsoft Teams

🚀 Quickstart

Connect to Microsoft Teams with Nango and see data flow in 2 minutes.

Create the integration

In Nango (free signup), go to Integrations -> Configure New Integration -> Microsoft Teams.

Authorize Microsoft Teams

Go to Connections -> Add Test Connection -> Authorize, then log in to Microsoft Teams. Later, you’ll let your users do the same directly from your app.

Call the Microsoft Teams API

Let’s make your first request to the Microsoft Teams (Microsoft Graph) API (fetch a list of teams joined by the authenticated user). Replace the placeholders below with your secret key, integration ID, and connection ID:

cURL
Node

curl "https://api.nango.dev/proxy/v1.0/me/joinedTeams" \
  -H "Authorization: Bearer <NANGO-SECRET-KEY>" \
  -H "Provider-Config-Key: <INTEGRATION-ID>" \
  -H "Connection-Id: <CONNECTION-ID>"

Install Nango’s backend SDK with npm i @nangohq/node. Then run:

import { Nango } from '@nangohq/node';

const nango = new Nango({ secretKey: '<NANGO-SECRET-KEY>' });

const res = await nango.get({
    endpoint: '/v1.0/me/joinedTeams',
    providerConfigKey: '<INTEGRATION-ID>',
    connectionId: '<CONNECTION-ID>'
});

console.log(res.data);

Or fetch credentials dynamically via the Node SDK or API.✅ You’re connected! Check the Logs tab in Nango to inspect requests.

Implement Nango in your app

Follow our Auth implementation guide to integrate Nango in your app.To obtain your own production credentials, follow the setup guide linked below.

📚 Microsoft Teams Integration Guides

Nango maintained guides for common use cases.

How to register your own Microsoft Teams OAuth app
Register an OAuth app with Microsoft Teams and obtain credentials to connect it to Nango

Official docs: Microsoft Graph API docs

🧩 Pre-built syncs & actions for Microsoft Teams

Enable them in your dashboard. Extend and customize to fit your needs.

Channels

Function name	Description	Type	Source code
`create-channel-message`	Post a root message in a channel	Action	🔗 Github
`create-channel-tab`	Add a tab to a channel.	Action	🔗 Github
`create-channel`	Create a channel in a team.	Action	🔗 Github
`delete-channel`	Delete a channel from a team	Action	🔗 Github
`get-channel-message`	Retrieve a channel message by ID.	Action	🔗 Github
`get-channel`	Retrieve a channel by ID.	Action	🔗 Github
`list-channel-messages`	List root messages in a channel.	Action	🔗 Github
`list-channel-replies`	List replies under a channel message thread	Action	🔗 Github
`list-channel-tabs`	List tabs configured on a channel.	Action	🔗 Github
`list-channels`	List channels in a team.	Action	🔗 Github
`update-channel`	Update mutable channel properties.	Action	🔗 Github

Chats

Function name	Description	Type	Source code
`create-chat-message`	Send a message in a chat	Action	🔗 Github
`create-chat`	Create a one-on-one or group chat.	Action	🔗 Github
`get-chat-message`	Retrieve a chat message by ID.	Action	🔗 Github
`list-chat-members`	List members in a chat	Action	🔗 Github
`list-chat-messages`	List messages in a chat.	Action	🔗 Github
`list-chats`	List chats for a user.	Action	🔗 Github

Messages

Function name	Description	Type	Source code
`reply-to-channel-message`	Reply to a channel message thread.	Action	🔗 Github

Teams

Function name	Description	Type	Source code
`add-team-member`	Add a member to a team	Action	🔗 Github
`create-team`	Create a team from a template or existing group.	Action	🔗 Github
`get-team`	Retrieve a team by ID.	Action	🔗 Github
`list-joined-teams`	List teams the user has joined	Action	🔗 Github
`list-team-members`	List members in a team.	Action	🔗 Github
`remove-team-member`	Remove a member from a team.	Action	🔗 Github

Others

Function name	Description	Type	Source code
`get-chat`	Retrieve a chat by ID.	Action	🔗 Github
`channel-message-replies`	Sync replies for selected channel message threads	Sync	🔗 Github
`channel-messages`	Sync root channel messages for selected channels	Sync	🔗 Github
`chat-members`	Sync member rosters for chats	Sync	🔗 Github
`chat-messages`	Sync chat messages across user chats.	Sync	🔗 Github
`chats`	Sync chats available to the user.	Sync	🔗 Github
`joined-teams`	Sync the teams joined by a user	Sync	🔗 Github
`org-units`	Sync Microsoft 365 or Entra groups used as organizational units	Sync	🔗 Github
`team-channels`	Sync channels for selected teams.	Sync	🔗 Github
`team-members`	Sync team membership rosters	Sync	🔗 Github
`users`	Sync directory users relevant to Microsoft Teams workspaces	Sync	🔗 Github

Overview

800+ APIs & Integrations

🚀 Quickstart

📚 Microsoft Teams Integration Guides

🧩 Pre-built syncs & actions for Microsoft Teams

Channels

Chats

Messages

Teams

Others

Overview

800+ APIs & Integrations

Documentation Index

​🚀 Quickstart

​📚 Microsoft Teams Integration Guides

​🧩 Pre-built syncs & actions for Microsoft Teams

​Channels

​Chats

​Messages

​Teams

​Others

🚀 Quickstart

📚 Microsoft Teams Integration Guides

🧩 Pre-built syncs & actions for Microsoft Teams

Channels

Chats

Messages

Teams

Others