SharePoint

Configuration

SharePoint source connector integrates with the Microsoft Graph API.

Synchronizes data from SharePoint including sites, document libraries, files, users, and groups.

It provides comprehensive access to SharePoint resources with intelligent error handling 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:

SharePointUserEntity

Schema for a SharePoint user.

Reference: https://learn.microsoft.com/en-us/graph/api/resources/user

Field	Type	Description
id	str	SharePoint user ID.
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.
mobile_phone	Optional[str]	The primary cellular telephone number for the user.
business_phones	Optional[List[str]]	The telephone numbers for the user.
account_enabled	Optional[bool]	Whether the account is enabled.
web_url_override	Optional[str]	Link to the user's profile in SharePoint.

SharePointGroupEntity

Schema for a SharePoint group.

Reference: https://learn.microsoft.com/en-us/graph/api/resources/group

Field	Type	Description
id	str	Group ID.
display_name	str	The display name for the group.
description	Optional[str]	An optional description for the group.
mail	Optional[str]	The SMTP address for the group.
mail_enabled	Optional[bool]	Whether the group is mail-enabled.
security_enabled	Optional[bool]	Whether the group is a security group.
group_types	List[str]	Specifies the group type (e.g., 'Unified' for Microsoft 365 groups).
visibility	Optional[str]	Visibility of the group (Public, Private, HiddenMembership).
web_url_override	Optional[str]	Link to the group in Microsoft 365.

SharePointSiteEntity

Schema for a SharePoint site.

Reference: https://learn.microsoft.com/en-us/graph/api/resources/site

Field	Type	Description
id	str	Site ID from Microsoft Graph.
display_name	str	The full title for the site.
site_name	Optional[str]	The name/title of the site.
description	Optional[str]	The descriptive text for the site.
web_url_override	Optional[str]	URL that displays the site in the browser.
is_personal_site	Optional[bool]	Whether the site is a personal site.
site_collection	Optional[Dict[str, Any]]	Details about the site's site collection.

SharePointDriveEntity

Schema for a SharePoint drive (document library).

Reference: https://learn.microsoft.com/en-us/graph/api/resources/drive

Field	Type	Description
id	str	Drive ID.
name	str	Drive name.
description	Optional[str]	User-visible description of the drive.
drive_type	Optional[str]	Type of drive (documentLibrary, business, etc.).
web_url_override	Optional[str]	URL to view the drive in a browser.
owner	Optional[Dict[str, Any]]	Information about the drive's owner.
quota	Optional[Dict[str, Any]]	Information about the drive's storage quota.
site_id	Optional[str]	ID of the site that contains this drive.

SharePointDriveItemEntity

Schema for a SharePoint drive item (file or folder).

Reference: https://learn.microsoft.com/en-us/graph/api/resources/driveitem

Field	Type	Description
id	str	Drive item ID.
name	str	Graph item name.
description	Optional[str]	User-visible description of the item.
web_url_override	Optional[str]	URL to display the item in a browser.
file	Optional[Dict[str, Any]]	File metadata if the item is a file (e.g., mimeType, hashes).
folder	Optional[Dict[str, Any]]	Folder metadata if the item is a folder (e.g., childCount).
parent_reference	Optional[Dict[str, Any]]	Information about the parent of this item (driveId, path, etc).
created_by	Optional[Dict[str, Any]]	Identity of the user who created the item.
last_modified_by	Optional[Dict[str, Any]]	Identity of the user who last modified the item.
site_id	Optional[str]	ID of the site that contains this item.
drive_id	Optional[str]	ID of the drive that contains this item.

SharePointListEntity

Schema for a SharePoint list.

Reference: https://learn.microsoft.com/en-us/graph/api/resources/list

Field	Type	Description
id	str	List ID.
display_name	str	The displayable title of the list.
list_name	Optional[str]	The name of the list.
description	Optional[str]	The description of the list.
web_url_override	Optional[str]	URL to view the list in browser.
list_info	Optional[Dict[str, Any]]	Additional list metadata (template, hidden, etc).
site_id	Optional[str]	ID of the site that contains this list.

SharePointListItemEntity

Schema for a SharePoint list item.

Reference: https://learn.microsoft.com/en-us/graph/api/resources/listitem

Field	Type	Description
id	str	List item ID.
title	str	Display title for the list item.
fields	Optional[Dict[str, Any]]	The values of the columns set on this list item (dynamic schema).
content_type	Optional[Dict[str, Any]]	The content type of this list item.
created_by	Optional[Dict[str, Any]]	Identity of the user who created the item.
last_modified_by	Optional[Dict[str, Any]]	Identity of the user who last modified the item.
web_url_override	Optional[str]	URL to view the item in browser.
list_id	Optional[str]	ID of the list that contains this item.
site_id	Optional[str]	ID of the site that contains this item.

SharePointPageEntity

Schema for a SharePoint site page.

Reference: https://learn.microsoft.com/en-us/graph/api/resources/sitepage

Field	Type	Description
id	str	Page ID.
title	str	The title of the page.
page_name	Optional[str]	The name of the page.
content	Optional[str]	The actual page content (extracted from webParts).
description	Optional[str]	Description or summary of the page content.
page_layout	Optional[str]	The layout type of the page (article, home, etc).
web_url_override	Optional[str]	URL to view the page in browser.
created_by	Optional[Dict[str, Any]]	Identity of the user who created the page.
last_modified_by	Optional[Dict[str, Any]]	Identity of the user who last modified the page.
publishing_state	Optional[Dict[str, Any]]	Publishing status of the page.
site_id	Optional[str]	ID of the site that contains this page.