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.
Based on the Microsoft Graph user resource. Reference: https://learn.microsoft.com/en-us/graph/api/resources/user
| Field | Type | Description |
|---|---|---|
| display_name | Optional[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. |
SharePointGroupEntity
Schema for a SharePoint group.
Based on the Microsoft Graph group resource. Reference: https://learn.microsoft.com/en-us/graph/api/resources/group
| Field | Type | Description |
|---|---|---|
| display_name | Optional[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). |
| created_datetime | Optional[datetime] | Timestamp when the group was created. |
SharePointSiteEntity
Schema for a SharePoint site.
Based on the Microsoft Graph site resource. Reference: https://learn.microsoft.com/en-us/graph/api/resources/site
| Field | Type | Description |
|---|---|---|
| display_name | Optional[str] | The full title for the site. |
| name | Optional[str] | The name/title of the site. |
| description | Optional[str] | The descriptive text for the site. |
| web_url | Optional[str] | URL that displays the site in the browser. |
| created_datetime | Optional[datetime] | Date and time the site was created. |
| last_modified_datetime | Optional[datetime] | Date and time the site was last modified. |
| 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).
Based on the Microsoft Graph drive resource. Reference: https://learn.microsoft.com/en-us/graph/api/resources/drive
| Field | Type | Description |
|---|---|---|
| name | Optional[str] | The name of the drive. |
| description | Optional[str] | User-visible description of the drive. |
| drive_type | Optional[str] | Type of drive (documentLibrary, business, etc.). |
| web_url | Optional[str] | URL to view the drive in a browser. |
| created_datetime | Optional[datetime] | Date and time the drive was created. |
| last_modified_datetime | Optional[datetime] | Date and time the drive was last modified. |
| 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).
Based on the Microsoft Graph driveItem resource. Reference: https://learn.microsoft.com/en-us/graph/api/resources/driveitem
| Field | Type | Description |
|---|---|---|
| name | str | The name of the item (file or folder). |
| description | Optional[str] | User-visible description of the item. |
| web_url | Optional[str] | URL to display the item in a browser. |
| created_datetime | Optional[datetime] | Date and time the item was created. |
| last_modified_datetime | Optional[datetime] | Date and time the item was last modified. |
| size | Optional[int] | Size of the item in bytes. |
| 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.
Based on the Microsoft Graph list resource. Reference: https://learn.microsoft.com/en-us/graph/api/resources/list
| Field | Type | Description |
|---|---|---|
| display_name | Optional[str] | The displayable title of the list. |
| name | Optional[str] | The name of the list. |
| description | Optional[str] | The description of the list. |
| web_url | Optional[str] | URL to view the list in browser. |
| created_datetime | Optional[datetime] | Date and time the list was created. |
| last_modified_datetime | Optional[datetime] | Date and time the list was last modified. |
| 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.
Based on the Microsoft Graph listItem resource. Reference: https://learn.microsoft.com/en-us/graph/api/resources/listitem
| Field | Type | Description |
|---|---|---|
| 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_datetime | Optional[datetime] | Date and time the item was created. |
| last_modified_datetime | Optional[datetime] | Date and time the item was last modified. |
| 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 | 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.
Based on the Microsoft Graph sitePage resource. Reference: https://learn.microsoft.com/en-us/graph/api/resources/sitepage
| Field | Type | Description |
|---|---|---|
| title | Optional[str] | The title of the 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 | Optional[str] | URL to view the page in browser. |
| created_datetime | Optional[datetime] | Date and time the page was created. |
| last_modified_datetime | Optional[datetime] | Date and time the page was last modified. |
| 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. |
