Microsoft Teams
Sync overview
Sync Microsoft Graph API data to work with Microsoft Teams.
Microsoft Graph REST APIs currently has two versions: v1.0 and beta. The beta version includes new or enhanced APIs that are still in preview. Preview APIs can change and may break existing scenarios without notice. Production dependencies on APIs in the beta endpoint aren’t recommended. This Source Connector is based on a API v1.0.
Output schema
This Source can sync the following core Streams:
- users
- groups
- group_members
- group_owners
- channels
- channel_members
- channel_tabs
- conversations
- conversation_threads
- conversation_posts
- team_drives
- team_device_usage_report
If you’d like Airbyte to support more endpoints, please create an issue.
Some APIs aren’t supported in v1.0, including channel messages and channel message replies.
Data type mapping
| Integration Type | Airbyte Type |
|---|---|
string | string |
number | number |
date | date |
datetime | timestamp_without_timezone |
array | array |
object | object |
Features
| Feature | Supported? |
|---|---|
| Full Refresh Sync | Yes |
| Incremental Sync | No |
| Replicate Incremental Deletes | No |
| SSL connection | Yes |
| Namespaces | No |
Performance considerations
Normal Microsoft Graph requests limitation restrict the connector.
Getting started
Requirements
- Application (client) ID
- Directory (tenant) ID
- Client secrets
Setup guide
The Microsoft Graph API uses OAuth for authentication. Microsoft Graph provides granular permissions controlling app access to resources such as users, groups and mail. When a user signs in, they or an administrator can consent to these permissions. After consent, your app can access its requested resources and APIs. For apps without a signed-in user, an administrator can pre-consent to permissions during installation.
Microsoft Graph has two permission types:
- Delegated permissions apply to apps with a signed-in user. The user or an administrator consents to the requested permissions. The app can then act as the signed-in user when calling Microsoft Graph. Non-administrative users can consent to some delegated permissions. Higher-privileged permissions require administrator consent.
- Application permissions apply to apps without a signed-in user, including background services or daemons. Only an administrator can consent to application permissions.
This source requires Application permissions. Follow these instructions to create an app in the Azure portal. This process provides the client_id, client_secret and tenant_id required for the tap configuration file.
- Sign in to Azure Portal
- Select the upper-left menu icon, then select Azure Active Directory
- Select App Registrations
- Select New registration
- Register an application
- Name:
- Supported account types: Accounts in this organizational directory only
- Register (button)
- Record the client_id and tenant_id. The tap uses them for authentication and API integration.
- Select Certificates & secrets
- Provide Description and Expires
- Description: tap-microsoft-teams client secret
- Expires: 1-year
- Add
- Copy the client secret value. This value is the client_secret.
- Select API permissions
- Select Add a permission
- Select Microsoft Graph
- Select Application permissions
- Select the following permissions:
- Users
- User.Read.All
- User.ReadWrite.All
- Directory.Read.All
- Directory.ReadWrite.All
- Groups
- GroupMember.Read.All
- Group.Read.All
- Directory.Read.All
- Group.ReadWrite.All
- Directory.ReadWrite.All
- Group members
- GroupMember.Read.All
- Group.Read.All
- Directory.Read.All
- Group owners
- Group.Read.All
- User.Read.All
- Group.Read.All
- User.ReadWrite.All
- Group.Read.All
- User.Read.All
- Application.Read.All
- Channels
- ChannelSettings.Read.Group
- ChannelSettings.ReadWrite.Group
- Channel.ReadBasic.All
- ChannelSettings.Read.All
- ChannelSettings.ReadWrite.All
- Group.Read.All
- Group.ReadWrite.All
- Directory.Read.All
- Directory.ReadWrite.All
- Channel members
- ChannelMember.Read.All
- ChannelMember.ReadWrite.All
- Channel tabs
- TeamsTab.Read.Group
- TeamsTab.ReadWrite.Group
- TeamsTab.Read.All
- TeamsTab.ReadWriteForTeam.All
- TeamsTab.ReadWrite.All
- Group.Read.All
- Group.ReadWrite.All
- Directory.Read.All
- Directory.ReadWrite.All
- Conversations
- Group.Read.All
- Group.ReadWrite.All
- Conversation threads
- Group.Read.All
- Group.ReadWrite.All
- Conversation posts
- Group.Read.All
- Group.ReadWrite.All
- Team drives
- Files.Read.All
- Files.ReadWrite.All
- Sites.Read.All
- Sites.ReadWrite.All
- Team device usage report
- Reports.Read.All
- Users
- Select Add permissions
instantiate implements token acquisition for the confidential client application using a client secret and calling AcquireTokenForClient from Microsoft Authentication Library (MSAL) for Python
IP allow list
If you use Airbyte Cloud and restrict access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.
Changelog
Expand to review
| Version | Date | Pull Request | Subject |
|---|---|---|---|
| 1.2.37 | 2026-11-03 | 90656 | Update dependencies |
| 1.2.36 | 2026-10-27 | 89978 | Update dependencies |
| 1.2.35 | 2026-10-20 | 89298 | Update dependencies |
| 1.2.34 | 2026-10-13 | 88697 | Update dependencies |
| 1.2.33 | 2026-10-06 | 87925 | Update dependencies |
| 1.2.32 | 2026-09-29 | 87272 | Update dependencies |
| 1.2.31 | 2026-09-22 | 86725 | Update dependencies |
| 1.2.30 | 2026-09-15 | 86124 | Update dependencies |
| 1.2.29 | 2026-09-08 | 85571 | Update dependencies |
| 1.2.28 | 2026-08-18 | 84667 | Update dependencies |
| 1.2.27 | 2026-08-11 | 84010 | Update dependencies |
| 1.2.26 | 2026-08-04 | 83526 | Update dependencies |
| 1.2.25 | 2026-07-28 | 83017 | Update dependencies |
| 1.2.24 | 2026-07-21 | 82492 | Update dependencies |
| 1.2.23 | 2026-07-14 | 81903 | Update dependencies |
| 1.2.22 | 2026-06-30 | 81155 | Update dependencies |
| 1.2.21 | 2026-06-23 | 80545 | Update dependencies |
| 1.2.20 | 2026-06-16 | 79958 | Update dependencies |
| 1.2.19 | 2026-06-09 | 79386 | Update dependencies |
| 1.2.18 | 2026-06-02 | 78850 | Update dependencies |
| 1.2.17 | 2026-04-28 | 77352 | Update dependencies |
| 1.2.16 | 2026-04-21 | 76682 | Update dependencies |
| 1.2.15 | 2026-03-31 | 75805 | Update dependencies |
| 1.2.14 | 2026-03-17 | 74567 | Update dependencies |
| 1.2.13 | 2026-03-03 | 73414 | Update dependencies |
| 1.2.12 | 2026-02-10 | 73207 | Update dependencies |
| 1.2.11 | 2026-02-03 | 72717 | Update dependencies |
| 1.2.10 | 2026-01-20 | 72026 | Update dependencies |
| 1.2.9 | 2026-01-14 | 71530 | Update dependencies |
| 1.2.8 | 2025-12-18 | 70764 | Update dependencies |
| 1.2.7 | 2025-12-02 | 66337 | Update dependencies |
| 1.2.6 | 2025-09-10 | 65755 | Update dependencies |
| 1.2.5 | 2025-08-23 | 65219 | Update dependencies |
| 1.2.4 | 2025-08-09 | 48176 | Update dependencies |
| 1.2.3 | 2024-10-29 | 47758 | Update dependencies |
| 1.2.2 | 2024-10-28 | 47453 | Update dependencies |
| 1.2.1 | 2024-08-16 | 44196 | Bump source-declarative-manifest version |
| 1.2.0 | 2024-08-15 | 44116 | Refactor connector to manifest-only format |
| 1.1.11 | 2024-08-12 | 43772 | Update dependencies |
| 1.1.10 | 2024-08-10 | 43547 | Update dependencies |
| 1.1.9 | 2024-08-03 | 43251 | Update dependencies |
| 1.1.8 | 2024-07-27 | 42691 | Update dependencies |
| 1.1.7 | 2024-07-20 | 41853 | Update dependencies |
| 1.1.6 | 2024-07-10 | 41382 | Update dependencies |
| 1.1.5 | 2024-07-09 | 41318 | Update dependencies |
| 1.1.4 | 2024-07-06 | 40913 | Update dependencies |
| 1.1.3 | 2024-06-25 | 40366 | Update dependencies |
| 1.1.2 | 2024-06-22 | 40026 | Update dependencies |
| 1.1.1 | 2024-06-04 | 39046 | [autopull] Upgrade base image to v1.2.1 |
| 1.1.0 | 2024-03-24 | 36223 | Migration to low code |
| 1.0.0 | 2024-01-04 | 33959 | Schema updates |
| 0.2.5 | 2021-12-14 | 8429 | Update titles and descriptions |
| 0.2.4 | 2021-12-07 | 7807 | Implement OAuth support |
| 0.2.3 | 2021-12-06 | 8469 | Migrate to the CDK |