---
title: Create a SAP DMS external content connector
description: Create an external content connector to retrieve searchable content and security principals from your SAP DMS source system.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/platform-administration/search-administration/create-ext-cont-connector-sap-dms.html
release: australia
product: Search Administration
classification: search-administration
topic_type: task
last_updated: "2026-09-15"
reading_time_minutes: 9
keywords: [ServiceNow Otto, AI Agents, generative AI, agentic AI]
breadcrumb: [SAP DMS external content connector, Configure, External Content Connectors, Search administration, Configure core features, Administer the ServiceNow AI Platform]
---

# Create a SAP DMS external content connector

Create an external content connector to retrieve searchable content and security principals from your SAP DMS source system.

## Before you begin

A source system administrator must have already configured your SAP DMS source system to allow access by the SAP DMS external content connector. For the required source system configuration steps, see [Configure SAP DMS for external content indexing](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/search-administration/configure-sap-dms-external-content-indexing.md).

Role required: sn\_ext\_conn.xcc\_admin

## Procedure

1.  Navigate to **All** > **External Content Connectors** > **External Content Admin Home**.

2.  If prompted to switch scope, select **Switch scope** and select the application scope specified in the prompt.

3.  In the Connectors section, select **New**.

4.  On the Choose source page, select the **SAP Document Management System** tile, then select **Next**.

5.  On the Connection settings page, fill in the connection settings.

<table id="table_uvz_jrv_sdc"><thead><tr><th>

Connection setting

</th><th>

Description

</th></tr></thead><tbody><tr><td>

Connector name

</td><td>

Unique name for this SAP DMS external content connector.

</td></tr><tr><td>

Client ID

</td><td>

Client ID from the service key for the Document Management Service, Integration Option service instance that's defined in a subaccount in your organization's SAP BTP global account.If you don't have the client ID from this service key, ask your SAP DMS administrator for it.

</td></tr><tr><td>

Client secret

</td><td>

Client secret from the service key for the Document Management Service, Integration Option service instance that's defined in a subaccount in your organization's SAP BTP global account.If you don't have the client secret from this service key, ask your SAP DMS administrator for it.

</td></tr><tr><td>

Connection URL

</td><td>

URL from the service key for the Document Management Service, Integration Option service instance that's defined in a subaccount in your organization's SAP BTP global account.If you don't have the URL from this service key, ask your SAP DMS administrator for it.

</td></tr><tr><td>

Base Web URL

</td><td>

Base web URL for documents in your SAP DMS tenant.If you don't have the base web URL, ask your SAP DMS administrator for it.

</td></tr><tr><td>

Endpoint URL

</td><td>

Endpoint URL for the ecmservice from the service key for the Document Management Service, Integration Option service instance that's defined in a subaccount in your organization's SAP BTP global account.If you don't have the endpoint URL from this service key, ask your SAP DMS administrator for it.

</td></tr><tr><td>

Role Collections Endpoint

</td><td>

Role collections endpoint URL from the service key for the Document Management Service, Integration Option service instance that's defined in a subaccount in your organization's SAP BTP global account.If you don't have the role collections endpoint URL from this service key, ask your SAP DMS administrator for it.

</td></tr><tr><td>

Client ID for token exchange

</td><td>

Client ID from the service key for the Authorization and Trust Management Service instance with the application plan that's defined in a subaccount in your organization's SAP BTP global account.If you don't have the client ID from this service key, ask your SAP DMS administrator for it.

</td></tr><tr><td>

Client secret for token exchange

</td><td>

Client secret from the service key for the Authorization and Trust Management Service instance with the application plan that's defined in a subaccount in your organization's SAP BTP global account.If you don't have the client secret from this service key, ask your SAP DMS administrator for it.

</td></tr></tbody>
</table>6.  Save and validate your connection settings by selecting **Validate Connection**.

    **Note:** If validation of your connection settings fails, the system shows an error message. Verify your connection settings to ensure they're correct. If permissions required by the connector are missing or incorrectly configured in the source system, a warning message appears showing the permissions that must be corrected. Provide the information from this message to your source system administrator.

7.  On the Client credentials screen, fill in the client credential settings.

<table id="table_esq_ykx_chc"><thead><tr><th>

Client credential setting

</th><th>

Description

</th></tr></thead><tbody><tr><td>

Client ID

</td><td>

Client ID from the service key for the Authorization and Trust Management Service instance that's defined in a subaccount in your organization's SAP BTP global account.If you don't have the client ID from this service key, ask your SAP DMS administrator for it.

</td></tr><tr><td>

Client secret

</td><td>

Client secret from the service key for the Authorization and Trust Management Service instance that's defined in a subaccount in your organization's SAP BTP global account.If you don't have the client secret from this service key, ask your SAP DMS administrator for it.

</td></tr><tr><td>

Connection URL

</td><td>

URL from the service key for the Authorization and Trust Management Service instance that's defined in a subaccount in your organization's SAP BTP global account.If you don't have the connection URL from this service key, ask your SAP DMS administrator for it.

</td></tr></tbody>
</table>8.  Save and validate your client credential settings by selecting **Validate connection**.

    **Note:** If validation of your client credential settings fails, the system shows an error message. Verify your client credential settings to ensure they're correct. If permissions required by the connector are missing or incorrectly configured in the source system, a warning message appears showing the permissions that need to be corrected. Provide the information from this message to your source system administrator.

9.  After your connection settings are validated, select **Next**.

10. On the Crawl settings page, modify any default crawl settings that you want to override for this connector, then select **Next**.

    If you want to skip this step for now, select **Skip** instead of **Next**. You can modify the crawl settings for this connector from the External Content Admin Home page. For details on this procedure and the available crawl settings, see [Configure crawl settings for a SAP DMS external content connector](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/search-administration/configure-crawl-settings-sap-dms-external-content-connector.md).

11. On the User permission settings page, modify any default user permission settings that you want to override for this connector.

    If you want to skip this step for now, select **Skip** instead of **Next**. You can modify the user permission settings for this connector from the External Content Admin Home page. For details on this procedure and user permission settings, see [Configure user permission settings for an external content connector](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/search-administration/configure-user-mapping-settings-external-content-connector.md).

12. On the Create crawl page, create a content crawl for this connector by selecting a crawl scope \(if supported\) and any desired options, then select **Next**.

    If you want to skip this step for now, select **Skip** instead of **Next**. You can create and run crawls for this connector from the External Content Admin Home page. For details on creating content crawls, see [Create a content crawl for an external content connector](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/search-administration/create-content-crawl-external-content-connector.md).

13. On the Connect search profile page, use the **Connect to search profile** field and **Add** button to add any search profiles that you want to connect this external content connector's default search source to, then select **Save**.

    If you want to skip this step for now, select **Skip** instead of **Next**. You can connect search sources for this connector to search profiles from the External Content Admin Home page. For details on connecting an external content connector to search profiles, see [Connect an external content connector to a search profile](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/search-administration/connect-external-content-connector-search-profile.md).

    When you link a connector search source to a search profile in this step, the system automatically publishes the search profile to make the new link take effect.


## Result

Your new external content connector appears in the Connectors list on the External Content Admin Home page.

## What to do next

To retrieve searchable content and security principals with your new connector, you must configure and run content and user mapping crawls for it. You can modify your new connector's crawl settings and create crawls for it from the External Content Admin Home page even if you skipped these steps during connector creation.

-   To learn how to configure your new connector's crawl settings, see [Configure crawl settings for a SAP DMS external content connector](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/search-administration/configure-crawl-settings-sap-dms-external-content-connector.md).
-   For details on creating crawls for your new connector, see [Create a content crawl for an external content connector](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/search-administration/create-content-crawl-external-content-connector.md) and [Create a user permission crawl for an external content connector](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/search-administration/create-user-mapping-crawl-external-content-connector.md).

To make content crawled by your new connector searchable in portals and search applications, you must link one of its search sources to the search profile used by each portal or search application. You can use the connector's default search source or create your own custom search sources.

-   **Default search source**

    By default, the system creates a search source that includes all content from your external content connector's indexed source.

-   **Custom search sources**

    You can create your own search sources with filters to specify which content from the connector's indexed source is searchable. To view the connector's indexed source, navigate to **All** &gt; **AI Search** &gt; **AI Search Index** &gt; **Indexed Sources**. For information about creating search sources, see [Search sources in AI Search](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/ai-search/search-sources-ais.md).


You can link connector search sources to search profiles from the External Content Admin Home page. For details on this procedure, see [Connect an external content connector to a search profile](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/search-administration/connect-external-content-connector-search-profile.md).

**Parent Topic:**[SAP DMS external content connector](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/platform-administration/search-administration/sap-dms-external-content-connector.md)