DocsConnectors

Outlook Mail

Outlook Mail logo

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:

Schema for an Outlook mail folder.

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

FieldTypeDescription
display_namestrDisplay name of the mail folder (e.g., ‘Inbox’).
parent_folder_idOptional[str]ID of the parent mail folder, if any.
child_folder_countOptional[int]Number of child mail folders under this folder.
total_item_countOptional[int]Total number of items (messages) in this folder.
unread_item_countOptional[int]Number of unread items in this folder.
well_known_nameOptional[str]Well-known name of this folder if applicable (e.g., ‘inbox’).

Schema for Outlook message entities.

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

FieldTypeDescription
folder_namestrName of the folder containing this message
subjectOptional[str]Subject line of the message
senderOptional[str]Email address of the sender
to_recipientsList[str]Recipients of the message
cc_recipientsList[str]CC recipients
sent_dateOptional[datetime]Date the message was sent
received_dateOptional[datetime]Date the message was received
body_previewOptional[str]Brief snippet of the message content
body_contentOptional[str]Full message body content
is_readboolWhether the message has been read
is_draftboolWhether the message is a draft
importanceOptional[str]Importance level (Low, Normal, High)
has_attachmentsboolWhether the message has attachments
internet_message_idOptional[str]Internet message ID

Schema for Outlook attachment entities.

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

FieldTypeDescription
message_idstrID of the message this attachment belongs to
attachment_idstrOutlook’s attachment ID
content_typeOptional[str]Content type of the attachment
is_inlineboolWhether this is an inline attachment
content_idOptional[str]Content ID for inline attachments
metadataDict[str, Any]Additional metadata about the attachment

Deletion signal for an Outlook message.

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

FieldTypeDescription
message_idstrID of the deleted message
deletion_statusstrStatus indicating the entity was removed (e.g., ‘removed’)

Deletion signal for an Outlook mail folder.

Emitted when the Graph delta API reports a folder was removed. The entity_id matches the original folder’s id.

FieldTypeDescription
folder_idstrID of the deleted folder
deletion_statusstrStatus indicating the entity was removed (e.g., ‘removed’)