---
schema_version: "1"
id: 1e5b7668eb24faad0de1f483188626e5c2b49ec289b4e54e05b0b66a7b55fd68
title: Create External Credentials for the Microsoft SharePoint Unstructured (Documents) Connector
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/data-cloud/data-cloud-int/guides/microsoftsharepoint/c360-a-microsoftsharepoint-unstructured-cred.md
canonical_url: https://developer.salesforce.com/docs/data/data-cloud-int/guide/c360-a-microsoftsharepoint-unstructured-cred.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: afbcfd2f84815461b302157c5ce21cf1b7d2702c97a3590235721ff720fbf285
products:
  - Data 360 Integration Guide
  - Data 360 Developer Documentation
---
# Create External Credentials for the Microsoft SharePoint Unstructured (Documents) Connector

To ingest unstructured data from Microsoft SharePoint to Data 360, set up an external credential for Microsoft SharePoint.

## Before You Begin

1.  Configure a [Microsoft Azure app](https://help.salesforce.com/s/articleView?id=ind.sf_contracts_create_a_microsoft_azure_app.htm&type=5).

    - Add this additional permission: `Sites.Read.All`.

2.  Follow the steps in [Prepare Your Microsoft SharePoint Unstructured Connection](https://developer.salesforce.com/docs/data/data-cloud-int/guide/c360-a-prepare-microsoftsharepoint-unstructured-connection.md).

## Set Up an External Credential

1.  From Setup, in the Quick Find box, enter `Named Credentials`. Then select **Named Credentials** (1).

    ![namedcredential definition](https://developer.salesforce.com/media/NamedCred_13Aug2024.png)

2.  On the External Credentials tab (2), click **New**.

    1.  Enter a label and name for your external credential. The name can't contain spaces. You can use underscores.

    2.  For Authentication Protocol, select **OAuth 2.0**.

    3.  For Authentication Flow Type, select **Browser Flow**.

    4.  For Authentication Provider, select the provider you created.

    5.  Click **Save**.

3.  Add principal to external credentials

    1.  In the external credentials that you created, under Principals, click **New**.

    2.  Enter the parameter name. You can include spaces.

    3.  For Identity Type, select **Named Principal**.

    4.  Add the scope, `offline_access https://graph.microsoft.com/.default`.

    5.  Set the Sequence Number to `1`.

    6.  Click **Save**.

4.  Authenticate your external credentials.

    1.  Under Principals, from the Actions dropdown menu, select **Authenticate.**

    2.  Follow the authentication flow and confirm access permissions.

    3.  To connect Data Cloud to Microsoft SharePoint, click **Allow**.

        After you authenticate, the status changes to Configured.

5.  Define the named credential.

    1.  In the Named Credentials Tab, click **New**. Then enter a label and name. The name can't contain spaces, but you can use underscores.

    2.  For the URL, enter `https://www.sharepoint.microsoft.com`.

    3.  For external credentials, select the credential that you created.

    4.  Click **Save**.

6.  Enable external credentials access.

    1.  From Setup, in the Quick Find box, enter `Profiles`. Then select it.

    2.  Click **System Administrator**.

    3.  On the Enable External Credential Principal Access tab, click **Edit**.

    4.  Add the external credentials principal that you created to the Enabled External Credentials Principals column.

    5.  Click **Save**.

7.  Use permission sets to assign external credential principal access.

    1.  From Setup, in the Quick Find box, enter `Permission Sets`.

    2.  On the Permissions Sets page, click **New**.

    3.  Enter a label for the permission set, for example `SharePoint_Permission_Set`, and then click **Save**.

    4.  In the newly created permission set, scroll to the Apps section and click **External Credential Principal Access**, and then click **Edit**.

    5.  From the Available External Credential Principals list, select the external credential principal you created earlier and move it to the Enabled External Credential Principals list, and then click **Save**.

    6.  On the new permission set page, click **Manage Assignments** > **Add Assignments**.

    7.  Select a user to ingest unstructured data into Data Cloud , click **Assign**, and then click **Done**.

## Locate Your SharePoint Site ID

You need your SharePoint Site ID to create a data stream. Ask your SharePoint administrator, or do **one** of the following:

- Go to the SharePoint site and click **Settings**. Select **Site information**. The ID is located under the URL heading.

- Alternatively, place the URL of your SharePoint site within a browser and append `/_api/site/id/` to the end of the URL. For example: `https://yoursite.sharepoint.com/sites/dir/_api/site/id`. The API returns a message. Note the value for `Edm.Guid`. This is your Site ID.

## Next Step

- [Set Up a Microsoft SharePoint Unstructured (Documents) Connection](https://developer.salesforce.com/docs/data/data-cloud-int/guide/c360-a-set-up-microsoftsharepoint-unstructured-connection.md)