Outlook Calendar

Connect your Outlook Calendar data to Airweave

Overview

The Outlook Calendar connector allows you to sync data from Outlook Calendar into Airweave, making it available for search and retrieval by your agents.

Configuration

OutlookCalendarSource

Outlook Calendar source implementation (read-only).

View Source Code

Explore the Outlook Calendar connector implementation

Authentication

This connector uses OAuth 2.0 with refresh token.

You can connect through the Airweave UI, which will guide you through the OAuth flow.

Entities

The following data models are available for this connector:

OutlookCalendarCalendarEntity

Schema for an Outlook Calendar object.

The inherited entity_id field stores the calendar’s Microsoft Graph ID.

Field	Type	Description
name	Optional[str]	The display name of the calendar.
color	Optional[str]	Indicates the color theme for the calendar.
change_key	Optional[str]	Identifies the version of the calendar object. Every time the calendar changes, changeKey changes.
can_edit	bool	Indicates if the user can write to the calendar.
can_share	bool	Indicates if the user has the ability to share the calendar.
can_view_private_items	bool	Indicates if the user can view private events on the calendar.
owner	Optional[Dict[str, Any]]	Details about the calendar’s owner. Usually includes name and address fields.

OutlookCalendarEventEntity

Schema for an Outlook Calendar Event object.

The inherited entity_id field stores the event’s Microsoft Graph ID.

Field	Type	Description
subject	Optional[str]	The subject or title of the event.
body_preview	Optional[str]	A short text preview of the event body.
body_content	Optional[str]	Full body content (HTML or text).
start_datetime	Optional[datetime]	The date/time when the event starts, in UTC. Derived from ‘start.dateTime’ if present.
start_timezone	Optional[str]	Time zone for the start time, from ‘start.timeZone’.
end_datetime	Optional[datetime]	The date/time when the event ends, in UTC. Derived from ‘end.dateTime’ if present.
end_timezone	Optional[str]	Time zone for the end time, from ‘end.timeZone’.
is_all_day	bool	Indicates if the event lasts all day.
is_cancelled	bool	Indicates if the event has been canceled.
show_as	Optional[str]	The status to show. E.g., ‘busy’, ‘tentative’, ‘free’.
importance	Optional[str]	Indicates the importance of the event.
sensitivity	Optional[str]	Indicates the sensitivity of the event (normal, personal, private, confidential).
organizer	Optional[Dict[str, Any]]	Information about the organizer of the event, typically includes email address and name.
attendees	Optional[List[Dict[str, Any]]]	List of attendees. Each dict usually includes email address info and response status.
location	Optional[Dict[str, Any]]	Information about the location where the event is held. Usually includes display address, unique identifier, and unique location type.
created_at	Optional[datetime]	Timestamp when the event was created, from ‘createdDateTime’.
updated_at	Optional[datetime]	Timestamp when the event was last modified, from ‘lastModifiedDateTime’.
web_link	Optional[str]	A URL that opens the event in Outlook on the web.
online_meeting_url	Optional[str]	A URL to join the meeting online if the event has online meeting info (e.g., Microsoft Teams).
series_master_id	Optional[str]	If this is part of a recurring series, specifies the ID of the master recurring event.
recurrence	Optional[Dict[str, Any]]	When present, indicates the recurrence pattern of a repeating event.