Enable Sync for Drive Map

POST

/sharepoint-service/api/v2/sharepoint/enable-sync

Enable real-time synchronization for a drive map that currently has sync disabled.

This endpoint retroactively enables sync for drive maps that were created with
sync_enabled=False (e.g., due to initial setup issues or manual configuration).
It creates a Microsoft Graph webhook subscription for real-time change notifications,
or falls back to polling mode if webhook creation fails.

Sync Modes:

Webhook Mode: Real-time notifications from Microsoft Graph when files change

Polling Mode: Periodic sync every 6 hours (fallback when webhooks fail)

Nested Subsite Support:
The endpoint automatically handles nested SharePoint subsites, correctly resolving
cases where the list's actual parent site differs from the originally stored site ID.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Sync successfully enabled (or already enabled)

Bodyapplication/json

🟠400

🟠401

🟠404

🟠422

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location --globoff 'https:///sharepoint-service/api/v2/sharepoint/enable-sync' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{
    "drive_map_id": 123
}'

Response Example

200 - Example 1

{
    "data": {
        "drive_id": "drive-guid",
        "drive_map_id": 123,
        "list_id": "list-guid",
        "list_name": "Documents",
        "note": "Using webhook mode",
        "site_id": "site-guid",
        "subscription_exp": "2025-02-04T12:00:00+00:00",
        "subscription_id": "abc-123-def",
        "sync_mode": "webhook"
    },
    "message": "Sync successfully enabled using real-time webhook",
    "success": true
}

Unsubscribe from SharePoint Webhook