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.

Source Code: View on GitHub

Authentication

This connector uses OAuth 2.0 authentication. You can connect through the Graffo 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:

TeamsUserEntity

Schema for a Microsoft Teams user.

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

Field	Type	Description
id	str	User ID from Microsoft Graph.
display_name	str	The name displayed in the address book for the user.
user_principal_name	Optional[str]	The user principal name (UPN) of the user (e.g., [email protected]).
mail	Optional[str]	The SMTP address for the user.
job_title	Optional[str]	The user's job title.
department	Optional[str]	The department in which the user works.
office_location	Optional[str]	The office location in the user's place of business.
web_url_override	Optional[str]	Link to the user in Microsoft 365.

TeamsTeamEntity

Schema for a Microsoft Teams team.

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

Field	Type	Description
id	str	Team ID from Microsoft Graph.
display_name	str	The name of the team.
description	Optional[str]	An optional description for the team.
visibility	Optional[str]	The visibility of the group and team (Public, Private, HiddenMembership).
is_archived	Optional[bool]	Whether this team is in read-only mode.
classification	Optional[str]	Classification for the team (e.g., low, medium, high business impact).
specialization	Optional[str]	Indicates whether the team is intended for a particular use case.
internal_id	Optional[str]	A unique ID for the team used in audit logs.
web_url_override	Optional[str]	Link to open the team in Microsoft Teams.

TeamsChannelEntity

Schema for a Microsoft Teams channel.

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

Field	Type	Description
id	str	Channel ID.
team_id	str	ID of the team this channel belongs to.
display_name	str	Channel name as it appears to users.
description	Optional[str]	Optional textual description for the channel.
email	Optional[str]	The email address for sending messages to the channel.
membership_type	Optional[str]	The type of the channel (standard, private, shared).
is_archived	Optional[bool]	Indicates whether the channel is archived.
is_favorite_by_default	Optional[bool]	Indicates whether the channel is recommended for all team members.
web_url_override	Optional[str]	A hyperlink that goes to the channel in Microsoft Teams.

TeamsChatEntity

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

Field	Type	Description
id	str	Chat ID.
chat_type	str	Type of chat (oneOnOne, group, meeting).
topic_label	str	Display label for the chat.
topic	Optional[str]	Subject or topic for the chat (only for group chats).
web_url_override	Optional[str]	The URL for the chat in Microsoft Teams.

TeamsMessageEntity

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

Field	Type	Description
id	str	Message ID.
team_id	Optional[str]	ID of the team (if this is a channel message).
channel_id	Optional[str]	ID of the channel (if this is a channel message).
chat_id	Optional[str]	ID of the chat (if this is a chat message).
reply_to_id	Optional[str]	ID of the parent message (for replies).
message_type	Optional[str]	Type of message (message, chatEvent, systemEventMessage).
created_datetime	Optional[datetime]	When the message was created.
subject	str	The subject of the chat message.
body_content	Optional[str]	The content of the message body.
body_content_type	Optional[str]	The type of the content (html or text).
from_user	Optional[Dict[str, Any]]	Details of the sender of the message.
last_edited_datetime	Optional[datetime]	Timestamp when edits to the message were made.
deleted_datetime	Optional[datetime]	Timestamp at which the message was deleted.
importance	Optional[str]	The importance of the message (normal, high, urgent).
mentions	List[Dict[str, Any]]	List of entities mentioned in the message.
attachments	List[Dict[str, Any]]	References to attached objects like files, tabs, meetings.
reactions	List[Dict[str, Any]]	Reactions for this message (e.g., Like).
web_url_override	Optional[str]	Link to the message in Microsoft Teams.