Sharepoint
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.
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
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., user@contoso.com). |
| 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. |
| 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. |
