Outlook Calendar

Configuration

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

Synchronizes data from Outlook calendars.

It provides comprehensive access to calendars, events, and attachments with proper timezone handling and meeting management features.

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:

OutlookCalendarCalendarEntity

Schema for an Outlook Calendar object.

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

Field	Type	Description
id	str	Calendar ID from Microsoft Graph.
name	str	Calendar display name.
color	Optional[str]	Color theme to distinguish the calendar (auto, lightBlue, etc.).
hex_color	Optional[str]	Calendar color in hex format (e.g., #FF0000).
change_key	Optional[str]	Version identifier that changes when the calendar is modified.
can_edit	bool	Whether the user can write to the calendar.
can_share	bool	Whether the user can share the calendar.
can_view_private_items	bool	Whether the user can view private events in the calendar.
is_default_calendar	bool	Whether this is the default calendar for new events.
is_removable	bool	Whether this calendar can be deleted from the mailbox.
is_tallying_responses	bool	Whether this calendar supports tracking meeting responses.
owner	Optional[Dict[str, Any]]	Information about the calendar owner (name and email).
allowed_online_meeting_providers	List[str]	Online meeting providers that can be used (teamsForBusiness, etc.).
default_online_meeting_provider	Optional[str]	Default online meeting provider for this calendar.
web_url_override	Optional[str]	URL to open this calendar in Outlook on the web.

OutlookCalendarEventEntity

Schema for an Outlook Calendar Event object.

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

Field	Type	Description
id	str	Event ID from Microsoft Graph.
subject	str	The subject/title of the event.
body_preview	Optional[str]	Preview of the event body content.
body_content	Optional[str]	Full body content of the event.
body_content_type	Optional[str]	Content type of the body (html or text).
start_datetime	Optional[Any]	Start date and time of the event.
start_timezone	Optional[str]	Timezone for the start time.
end_datetime	Optional[Any]	End date and time of the event.
end_timezone	Optional[str]	Timezone for the end time.
is_all_day	bool	Whether the event lasts all day.
is_cancelled	bool	Whether the event has been cancelled.
is_draft	bool	Whether the event is a draft.
is_online_meeting	bool	Whether this is an online meeting.
is_organizer	bool	Whether the user is the organizer.
is_reminder_on	bool	Whether a reminder is set.
show_as	Optional[str]	How to show time (free, busy, tentative, oof, etc.).
importance	Optional[str]	Importance level (low, normal, high).
sensitivity	Optional[str]	Sensitivity level (normal, personal, private, confidential).
response_status	Optional[Dict[str, Any]]	Response status of the user to the event.
organizer	Optional[Dict[str, Any]]	Event organizer information (name and email).
attendees	Optional[List[Dict[str, Any]]]	List of event attendees with their response status.
location	Optional[Dict[str, Any]]	Primary location information for the event.
locations	List[Dict[str, Any]]	List of all locations associated with the event.
categories	List[str]	Categories assigned to the event.
web_link	Optional[str]	URL to open the event in Outlook on the web.
online_meeting_url	Optional[str]	URL to join the online meeting.
online_meeting_provider	Optional[str]	Online meeting provider (teamsForBusiness, etc.).
online_meeting	Optional[Dict[str, Any]]	Online meeting details and join information.
series_master_id	Optional[str]	ID of the master event if this is part of a recurring series.
recurrence	Optional[Dict[str, Any]]	Recurrence pattern for recurring events.
reminder_minutes_before_start	Optional[int]	Minutes before start time when reminder fires.
has_attachments	bool	Whether the event has attachments.
ical_uid	Optional[str]	Unique identifier across calendars.
change_key	Optional[str]	Version identifier that changes when event is modified.
original_start_timezone	Optional[str]	Start timezone when event was originally created.
original_end_timezone	Optional[str]	End timezone when event was originally created.
allow_new_time_proposals	bool	Whether invitees can propose new meeting times.
hide_attendees	bool	Whether attendees are hidden from each other.
created_datetime	Optional[Any]	When the event was created.
last_modified_datetime	Optional[Any]	When the event was last modified.
web_url_override	Optional[str]	URL to open the event in Outlook on the web.

OutlookCalendarAttachmentEntity

Schema for Outlook Calendar Event attachments.

Represents files attached to calendar events.

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

Field	Type	Description
composite_id	str	Composite attachment ID (event + attachment).
name	str	Attachment display name.
event_id	str	ID of the event this attachment belongs to
attachment_id	str	Microsoft Graph attachment ID
content_type	Optional[str]	MIME type of the attachment
is_inline	bool	Whether the attachment is inline
content_id	Optional[str]	Content ID for inline attachments
last_modified_at	Optional[str]	When the attachment was last modified
event_web_url	Optional[str]	URL to the parent event.