DocsConnectors

Teams

Teams logo

Teams

Configuration

Microsoft Teams source connector integrates with the Microsoft Graph API.

Synchronizes data from Microsoft Teams including teams, channels, chats, and messages.

It provides comprehensive access to Teams resources with proper token refresh and rate limiting.

View Source Code

Explore the Teams connector implementation

Authentication

This connector uses OAuth 2.0 authentication. You can connect through the Airweave UI or API using the OAuth flow.

Supported authentication methods:

  • OAuth Browser Flow (recommended for UI)
  • OAuth Token (for programmatic access)
  • Auth Provider (enterprise SSO)

Configuration Options

This connector does not have any additional configuration options.

Data Models

The following data models are available for this connector:

Schema for a Microsoft Teams user.

Based on the Microsoft Graph user resource. Reference: https://learn.microsoft.com/en-us/graph/api/resources/user

FieldTypeDescription
display_nameOptional[str]The name displayed in the address book for the user.
user_principal_nameOptional[str]The user principal name (UPN) of the user (e.g., user@contoso.com).
mailOptional[str]The SMTP address for the user.
job_titleOptional[str]The user’s job title.
departmentOptional[str]The department in which the user works.
office_locationOptional[str]The office location in the user’s place of business.

Schema for a Microsoft Teams team.

Based on the Microsoft Graph team resource. Reference: https://learn.microsoft.com/en-us/graph/api/resources/team

FieldTypeDescription
display_namestrThe name of the team.
descriptionOptional[str]An optional description for the team.
visibilityOptional[str]The visibility of the group and team (Public, Private, HiddenMembership).
is_archivedOptional[bool]Whether this team is in read-only mode.
web_urlOptional[str]A hyperlink that goes to the team in Microsoft Teams.
created_datetimeOptional[datetime]Timestamp at which the team was created.
classificationOptional[str]Classification for the team (e.g., low, medium, high business impact).
specializationOptional[str]Indicates whether the team is intended for a particular use case.
internal_idOptional[str]A unique ID for the team used in audit logs.

Schema for a Microsoft Teams channel.

Based on the Microsoft Graph channel resource. Reference: https://learn.microsoft.com/en-us/graph/api/resources/channel

FieldTypeDescription
team_idstrID of the team this channel belongs to.
display_namestrChannel name as it appears to users.
descriptionOptional[str]Optional textual description for the channel.
emailOptional[str]The email address for sending messages to the channel.
membership_typeOptional[str]The type of the channel (standard, private, shared).
is_archivedOptional[bool]Indicates whether the channel is archived.
is_favorite_by_defaultOptional[bool]Indicates whether the channel is recommended for all team members.
web_urlOptional[str]A hyperlink that goes to the channel in Microsoft Teams.
created_datetimeOptional[datetime]Timestamp at which the channel was created.

Schema for a Microsoft Teams chat (1:1, group, or meeting chat).

Based on the Microsoft Graph chat resource. Reference: https://learn.microsoft.com/en-us/graph/api/resources/chat

FieldTypeDescription
chat_typestrType of chat (oneOnOne, group, meeting).
topicOptional[str]Subject or topic for the chat (only for group chats).
created_datetimeOptional[datetime]Date and time at which the chat was created.
last_updated_datetimeOptional[datetime]Date and time at which the chat was last updated.
web_urlOptional[str]The URL for the chat in Microsoft Teams.

Schema for a Microsoft Teams message (in channel or chat).

Based on the Microsoft Graph chatMessage resource. Reference: https://learn.microsoft.com/en-us/graph/api/resources/chatmessage

FieldTypeDescription
team_idOptional[str]ID of the team (if this is a channel message).
channel_idOptional[str]ID of the channel (if this is a channel message).
chat_idOptional[str]ID of the chat (if this is a chat message).
reply_to_idOptional[str]ID of the parent message (for replies).
message_typeOptional[str]Type of message (message, chatEvent, systemEventMessage).
subjectOptional[str]The subject of the chat message.
body_contentOptional[str]The content of the message body.
body_content_typeOptional[str]The type of the content (html or text).
from_userOptional[Dict[str, Any]]Details of the sender of the message.
created_datetimeOptional[datetime]Timestamp of when the message was created.
last_modified_datetimeOptional[datetime]Timestamp when the message was last modified.
last_edited_datetimeOptional[datetime]Timestamp when edits to the message were made.
deleted_datetimeOptional[datetime]Timestamp at which the message was deleted.
importanceOptional[str]The importance of the message (normal, high, urgent).
mentionsList[Dict[str, Any]]List of entities mentioned in the message.
attachmentsList[Dict[str, Any]]References to attached objects like files, tabs, meetings.
reactionsList[Dict[str, Any]]Reactions for this message (e.g., Like).
web_urlOptional[str]Link to the message in Microsoft Teams.