---
title: "Azure Cosmos DB Connector"
slug: "azure-cosmos-db-connector"
description: "Manage Azure Cosmos DB (Core/SQL): create, list, get, update & delete databases, collections and JSON documents with partition keys & ETags."
updated: 2026-07-17T15:43:13Z
published: 2026-06-12T14:38:12Z
canonical: "docs.lansweeper.com/azure-cosmos-db-connector"
---

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

# Azure Cosmos DB Connector

Note on third‑party tools

              

We aim to provide accurate and helpful details about third‑party tools, but we can’t guarantee that this information is always complete or up to date. If you notice any discrepancies, feel free to share them in the feedback section below. For the most reliable information, please always refer to the third‑party tool’s official documentation.

[Azure Cosmos DB](https://azure.microsoft.com/en-us/services/cosmos-db/) is a Microsoft database service designed for handling various applications.

Manage databases, collections, and documents within Azure Cosmos DB.

## API Documentation

This component was built using the [Azure Cosmos DB (SQL) REST API](https://learn.microsoft.com/en-us/rest/api/cosmos-db/).

## Connections

### Master Key

Azure Cosmos DB Master Key

To authenticate this component using your Cosmos DB **Core (SQL) API** master key:

1. Navigate to [Azure Portal](https://portal.azure.com/).
2. Find your **Cosmos DB account**.
3. In the left menu, under **Settings**, select **Keys**.
4. Copy the **Primary Key** or **Secondary Key**.

You will also need the **Cosmos DB account name** (subdomain). For example, if your endpoint is: `https://your-cosmos-account.documents.azure.com/`

Then your account name is: `your-cosmos-account`

Use these values to configure the component connection.

| Input | Comments | Default |
| --- | --- | --- |
| Endpoint | Your Azure Cosmos DB account endpoint URL. |  |
| Master Key | Your Azure Cosmos DB account master key. You can find this in the Azure Cosmos DB account settings. |  |

## Actions

### Create Collection

Create a new collection in a database

| Input | Comments | Default |
| --- | --- | --- |
| Connection | Azure Cosmos DB connection configured with endpoint URL and access key. |  |
| Database ID | The ID of the database. |  |
| Collection ID | The ID of the collection. |  |
| Partition Key Path | The path used as the partition key when creating the collection, e.g., `/category`. |  |
| Throughput (RU/s) | The provisioned throughput for the collection in Request Units per second. **Note:** Serverless collections do not support setting throughput. |  |

### Create Database

Create a new database in Cosmos DB

| Input | Comments | Default |
| --- | --- | --- |
| Connection | Azure Cosmos DB connection configured with endpoint URL and access key. |  |
| Database ID | The ID of the database. |  |

### Create Document

Create a new document in a collection

| Input | Comments | Default |
| --- | --- | --- |
| Connection | Azure Cosmos DB connection configured with endpoint URL and access key. |  |
| Database ID | The ID of the database. |  |
| Collection ID | The ID of the collection. |  |
| Document | The document as JSON string. |  |
| Partition Key Value | The value of the partition key for the document (required for partitioned collections). |  |

### Delete Collection

Delete a collection from a database

| Input | Comments | Default |
| --- | --- | --- |
| Connection | Azure Cosmos DB connection configured with endpoint URL and access key. |  |
| Database ID | The ID of the database. |  |
| Collection ID | The ID of the collection. |  |

### Delete Database

Delete a database from Cosmos DB

| Input | Comments | Default |
| --- | --- | --- |
| Connection | Azure Cosmos DB connection configured with endpoint URL and access key. |  |
| Database ID | The ID of the database. |  |

### Delete Document

Delete a document from a collection

| Input | Comments | Default |
| --- | --- | --- |
| Connection | Azure Cosmos DB connection configured with endpoint URL and access key. |  |
| Database ID | The ID of the database. |  |
| Collection ID | The ID of the collection. |  |
| Document ID | The ID of the document. |  |
| Partition Key Value | The value of the partition key for the document (required for partitioned collections). |  |
| ETag | The ETag value for optimistic concurrency control. |  |

### Get Collection

Get a specific collection by ID

| Input | Comments | Default |
| --- | --- | --- |
| Connection | Azure Cosmos DB connection configured with endpoint URL and access key. |  |
| Database ID | The ID of the database. |  |
| Collection ID | The ID of the collection. |  |

### Get Database

Get a specific database by ID

| Input | Comments | Default |
| --- | --- | --- |
| Connection | Azure Cosmos DB connection configured with endpoint URL and access key. |  |
| Database ID | The ID of the database. |  |

### Get Document

Get a specific document by ID

| Input | Comments | Default |
| --- | --- | --- |
| Connection | Azure Cosmos DB connection configured with endpoint URL and access key. |  |
| Database ID | The ID of the database. |  |
| Collection ID | The ID of the collection. |  |
| Document ID | The ID of the document. |  |
| Partition Key Value | The value of the partition key for the document (required for partitioned collections). |  |

### List Collections

List all collections in a database

| Input | Comments | Default |
| --- | --- | --- |
| Connection | Azure Cosmos DB connection configured with endpoint URL and access key. |  |
| Database ID | The ID of the database. |  |

### List Databases

List all databases in the Cosmos DB account

| Input | Comments | Default |
| --- | --- | --- |
| Connection | Azure Cosmos DB connection configured with endpoint URL and access key. |  |

### List Documents

List all documents in a collection

| Input | Comments | Default |
| --- | --- | --- |
| Connection | Azure Cosmos DB connection configured with endpoint URL and access key. |  |
| Database ID | The ID of the database. |  |
| Collection ID | The ID of the collection. |  |
| Max Item Count | Maximum number of items to return. |  |
| Continuation Token | Token for pagination to get the next set of results. |  |
| Fetch All | If enabled, retrieves all documents by automatically fetching every page of results. This overrides 'Max Item Count' and ignores any 'Continuation Token'. | false |

### Update Document

Update an existing document in a collection

| Input | Comments | Default |
| --- | --- | --- |
| Connection | Azure Cosmos DB connection configured with endpoint URL and access key. |  |
| Database ID | The ID of the database. |  |
| Collection ID | The ID of the collection. |  |
| Document ID | The ID of the document. |  |
| Document | The document as JSON string. |  |
| Partition Key Value | The value of the partition key for the document (required for partitioned collections). |  |
| ETag | The ETag value for optimistic concurrency control. |  |