---
schema_version: "1"
id: 8cc2434ab4cc141f07f4a81fbefc7e6bd60f5eda61116c01181d5fc71dd2ff7a
title: Set Up an Azure Cosmos DB Connection (Beta)
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/data-cloud/data-cloud-int/guides/azurecosmosdb/c360-a-set-up-azurecosmosdb-connection.md
canonical_url: https://developer.salesforce.com/docs/data/data-cloud-int/guide/c360-a-set-up-azurecosmosdb-connection.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: c91f35d91f841ae9e6ef3c83076beeda58a7c987645e5b9c56bff9020944358e
products:
  - Data 360 Integration Guide
  - Data 360 Developer Documentation
---
# Set Up an Azure Cosmos DB Connection (Beta)

Set up the Azure Cosmos DB connection to start the flow of data into Data 360.

**note:** This feature is a Beta Service. A customer may opt to try a Beta Service in its sole discretion. Any use of the Beta Service is subject to the applicable Beta Services Terms provided at [Agreements and Terms.](https://www.salesforce.com/company/legal/agreements/) If you have questions or feedback about this Beta Service, contact the Data 360 Connector team at [datacloud-connectors-beta@salesforce.com.](mailto:datacloud-connectors-beta@salesforce.com)

| User Permissions Needed |                                                             |
| ----------------------- | ----------------------------------------------------------- |
| To create a connection: | System Admin profile or Data Cloud Architect permission set |

Before you begin:

- Enable the Beta connector through the feature manager. See [Enable Data 360 Features](https://help.salesforce.com/s/articleView?id=data.c360_a_feature_manager.htm&type=5).
- Verify your admin has enabled firewalls on the system you want Data 360 to connect to by including these [IP addresses](https://help.salesforce.com/s/articleView?id=data.c360_a_data_cloud_ip_address_allowlist.htm&type=5) to your allowlists.
- If using named credentials for Authentication Method, set up [OAuth based authentication](https://help.salesforce.com/s/articleView?id=data.c360_a_setup_oauth_openid.htm&type=5) or for [Microsoft](https://help.salesforce.com/s/articleView?id=data.c360_a_setup_oauth_microsoft.htm&type=5).
- Create external and named credentials.

1.  In Data Cloud, click **Setup**, and select **Data Cloud Setup**.

2.  Under External Integrations, select **Other Connectors**.

3.  Click **New**.

4.  On the Source tab, select **Azure Cosmos DB** and click **Next**.

5.  Enter a connection name and connection API name.

6.  For Authentication Details, select the Authentication Method that you want to use from the dropdown.

    1.  For Account Key, add an Account Endpoint, Account Key, and select either combo box master or result from the Token Type dropdown.

        Th account key is the Cosmos DB account URL from the Keys blade. The account key is a master key token or a resource token for connecting to the Azure Cosmos DB REST API. .

    2.  For Named Credentials, select from the dropdown.

7.  For Connection Details, add these optional inputs.

    1.  Enter an Azure Tenant based on the tenant ID of the OAuth Azure App you are using..

    2.  Select combo box global or china from the dropdown for the Azure Environment you want to use.

8.  To review your configuration, click **Test Connection**.

9.  Click **Save**.

After the connector details are accepted, the connection is created and listed under Connectors. You can now create data streams.

## Next Step

- [Create an Azure Cosmos DB Data Stream (Beta)](https://developer.salesforce.com/docs/data/data-cloud-int/guide/c360-a-create-azurecosmosdb-data-stream.md)