Outlook Mail

Configuration

Outlook Mail source connector integrates with the Microsoft Graph API to extract email data.

Synchronizes data from Outlook mailboxes.

It provides comprehensive access to mail folders, messages, and attachments with hierarchical folder organization and content processing capabilities.

View Source Code

Explore the Outlook Mail 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

The following configuration options are available for this connector:

Configuration Parameters

Outlook Mail configuration schema.

after_date

Optional[str]Required

Sync emails after this date (format: YYYY/MM/DD or YYYY-MM-DD).

included_folders

list[str]Defaults to []

Well-known folder names to include (e.g., ‘inbox’, ‘sentitems’, ‘drafts’). Defaults to inbox and sent items.

excluded_folders

list[str]Defaults to []

Well-known folder names to exclude (e.g., ‘junkemail’, ‘deleteditems’). Defaults to junk email and deleted items.

Data Models

The following data models are available for this connector:

OutlookMailFolderEntity

Schema for an Outlook mail folder.

See: https://learn.microsoft.com/en-us/graph/api/resources/mailfolder?view=graph-rest-1.0

Field	Type	Description
id	str	Mail folder ID from Microsoft Graph.
display_name	str	Display name of the mail folder (e.g., ‘Inbox’).
parent_folder_id	Optional[str]	ID of the parent mail folder, if any.
child_folder_count	Optional[int]	Number of child mail folders under this folder.
total_item_count	Optional[int]	Total number of items (messages) in this folder.
unread_item_count	Optional[int]	Number of unread items in this folder.
well_known_name	Optional[str]	Well-known name of this folder if applicable (e.g., ‘inbox’).
web_url_override	Optional[str]	URL to open this folder in Outlook on the web.

OutlookMessageEntity

Schema for Outlook message entities.

Reference: https://learn.microsoft.com/en-us/graph/api/resources/message?view=graph-rest-1.0

Field	Type	Description
id	str	Message ID from Microsoft Graph.
folder_name	str	Name of the folder containing this message
subject	str	Subject line of the message.
sender	Optional[str]	Email address of the sender
to_recipients	List[str]	Recipients of the message
cc_recipients	List[str]	CC recipients
sent_date	Optional[datetime]	Date the message was sent
received_date	Optional[datetime]	Date the message was received
body_preview	Optional[str]	Brief snippet of the message content
is_read	bool	Whether the message has been read
is_draft	bool	Whether the message is a draft
importance	Optional[str]	Importance level (Low, Normal, High)
has_attachments	bool	Whether the message has attachments
internet_message_id	Optional[str]	Internet message ID
web_url_override	Optional[str]	Link to the message in Outlook on the web.

OutlookAttachmentEntity

Schema for Outlook attachment entities.

Reference: https://learn.microsoft.com/en-us/graph/api/resources/fileattachment?view=graph-rest-1.0

Field	Type	Description
composite_id	str	Composite attachment ID (message + attachment).
name	str	Attachment filename.
message_id	str	ID of the message this attachment belongs to
attachment_id	str	Outlook’s attachment ID
content_type	Optional[str]	Content type of the attachment
is_inline	bool	Whether this is an inline attachment
content_id	Optional[str]	Content ID for inline attachments
metadata	Dict[str, Any]	Additional metadata about the attachment
message_web_url	Optional[str]	URL to the parent message in Outlook on the web.

OutlookMessageDeletionEntity

Deletion signal for an Outlook message.

Emitted when the Graph delta API reports a message was removed. The entity_id (derived from message_id) matches the original message’s id so downstream deletion can target the correct parent/children.

Field	Type	Description
message_id	str	ID of the deleted message
label	str	Human-readable deletion label

OutlookMailFolderDeletionEntity

Deletion signal for an Outlook mail folder.

Emitted when the Graph delta API reports a folder was removed. The entity_id (derived from folder_id) matches the original folder’s id.

Field	Type	Description
folder_id	str	ID of the deleted folder
label	str	Human-readable deletion label