SharePoint

SharePoint Connector

Microsoft Graph API connector for SharePoint list and library ingestion into DeepSigma canonical records.

Source: src/adapters/sharepoint/connector.py

---

Setup

Environment Variables

Variable	Required	Description
SP_TENANT_ID	Yes	Azure AD tenant ID
SP_CLIENT_ID	Yes	App registration client ID
SP_CLIENT_SECRET	Yes	App registration client secret
SP_SITE_ID	Yes	SharePoint site ID ({hostname},{site-collection-id},{web-id})
SP_WEBHOOK_SECRET	No	HMAC secret for webhook signature verification

Azure AD Permissions

• Sites.Read.All — list items
• Sites.ReadWrite.All — subscriptions (for delta sync)

---

Usage

from adapters.sharepoint.connector import SharePointConnector

connector = SharePointConnector()

# Fetch all items from a list
records = connector.list_items("my-list-id")

# Delta sync (incremental)
records, delta_token = connector.list_items_delta("my-list-id", delta_token=None)

Golden Path Integration

deepsigma golden-path sharepoint --list-id Documents --site-id "..."

Fixture Mode (no credentials)

deepsigma golden-path sharepoint \
  --fixture src/demos/golden_path/fixtures/sharepoint_small

---

Features

• Full sync — fetch all items from a SharePoint list
• Delta sync — incremental changes via Graph API delta queries
• Webhook subscriptions — real-time notifications for list changes
• Field mapping — transforms SharePoint fields to canonical record envelopes via llm_data_model/04_mappings/sharepoint_mapping.md
• Pagination — automatic @odata.nextLink handling
• Rate limiting — Graph API 429 backoff

---

Related Pages

• Power Platform — Dataverse connector
• Snowflake — Snowflake connector
• Integrations — All connector overview

Full documentation: docs/26-sharepoint-connector.md