> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zylon.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# SharePoint Integration

> Sync SharePoint documents into your workspace.

SharePoint integrations ingest libraries and documents into your workspace. **Enable SharePoint at the instance level first**—see the operator guide: [SharePoint integration setup](/en/operator-manual/knowledge-base/sharepoint).

If OAuth is required, use the login endpoints in [OpenID & OAuth](/en/developer-manual/build-with-zylon/workspace-api/authentication/openid).

## Basic request and response

Fetch integration configuration with `GET /api/v1/app/integration/sharepoint/{integrationId}/config`.

```bash theme={null}
curl "https://{BASE_URL}/api/v1/app/integration/sharepoint/{integrationID}/config" \
  -H "Authorization: Bearer {API_TOKEN}"
  -H "x-org: {org_slug}"
```

<Accordion title="Example response">
  ```json theme={null}
  {
    "site_url": "https://auroralabs.sharepoint.com/sites/support",
    "library": "Shared Documents"
  }
  ```
</Accordion>

## Start an ingest sync

```bash theme={null}
curl -X POST "https://{BASE_URL}/api/v1/app/integration/sharepoint/{integrationID}/ingest" \
  -H "Authorization: Bearer {API_TOKEN}" \
  -H "x-org: {org_slug}" \
  -H "Content-Type: application/json"
```

<Accordion title="Example response">
  ```json theme={null}
  {
    "type": "sync_started",
    "current_artifact_count": 18,
    "integration_item_count": 64
  }
  ```
</Accordion>

## Errors and edge cases

* **403**: integration not enabled or missing permissions.
* **404**: integration ID not found.