# Azure Cosmos DB integrations: databases

> Create a database, create a collection and create a document in Azure Cosmos DB.

**Canonical page:** https://tray.ai/connectors/azure-cosmos-db-integrations/
**Categories:** Data and analytics
**Connects through:** HTTP Connector

## Overview

Azure Cosmos DB is Microsoft's globally distributed NoSQL database service, storing JSON documents in databases and containers with built-in replication across Azure regions. Tray.ai connects to Azure Cosmos DB through the HTTP Connector, so your workflows can call the Azure Cosmos DB API alongside the rest of your stack.

## Use cases

### Databases

Read, create, and delete databases in Azure Cosmos DB from any Tray.ai workflow. The Azure Cosmos DB API covers calls such as list databases and create a database.

- List databases
- Create a database
- Get a database

### Collections

Read, create, and delete collections in Azure Cosmos DB from any Tray.ai workflow. The Azure Cosmos DB API covers calls such as list collections and create a collection.

- List collections
- Create a collection
- Replace a collection

### Documents

Read, create, and delete documents in Azure Cosmos DB from any Tray.ai workflow. The Azure Cosmos DB API covers calls such as list documents and create a document.

- List documents
- Create a document
- Replace a document

### Stored procedures

Read and create stored procedures in Azure Cosmos DB from any Tray.ai workflow. The Azure Cosmos DB API covers calls such as list stored procedures and create a stored procedure.

- List stored procedures
- Create a stored procedure
- Execute a stored procedure

### Users

Read, create, and delete users in Azure Cosmos DB from any Tray.ai workflow. The Azure Cosmos DB API covers calls such as list users and create a user.

- List users
- Create a user
- Delete a user

## Challenges Tray.ai solves

### Keeping Azure Cosmos DB credentials out of logs

A raw API call usually means pasting a key or token into the request, where it ends up in step inputs, logs, and screenshots.

**How Tray.ai helps:** Store Azure Cosmos DB credentials once as a Tray.ai authentication and reference them from the HTTP Connector. Tray.ai masks authentication values in logs, so the secret never shows up in a step's input or output.

### Going from the Azure Cosmos DB API docs to a working call

Translating an example request from API docs into a workflow step means copying the method, URL, headers, and body by hand.

**How Tray.ai helps:** Paste a cURL example from the Azure Cosmos DB API docs into the HTTP Connector and Tray.ai fills in the method, URL, headers, and body for you.

### Handling files and non-JSON responses

Not every API answers in JSON. Some return XML, files, or binary data, or expect a multipart upload.

**How Tray.ai helps:** The HTTP Connector parses JSON and XML responses, returns files you can pass to the next step, and sends multipart form data for uploads.

## Frequently asked questions

### Does Tray.ai connect to Azure Cosmos DB?

Yes. Tray.ai connects to Azure Cosmos DB through the HTTP Connector, which calls the Azure Cosmos DB API directly. Any call the Azure Cosmos DB API documents can run as a step in a Tray.ai workflow.

### How does Tray.ai authenticate with Azure Cosmos DB?

The Azure Cosmos DB API uses an API key in a request header and OAuth 2.0. You save it once as a Tray.ai authentication, and the HTTP Connector adds it to every request.

### Can I get a dedicated Azure Cosmos DB connector?

Azure Cosmos DB runs through the HTTP Connector rather than a dedicated connector. If your team wants one, the Tray.ai connector SDK can build a dedicated Azure Cosmos DB connector from the Azure Cosmos DB API.

## Learn more

- Intelligent Integration: https://tray.ai/platform/intelligent-ipaas/
- Merlin Agent Builder: https://tray.ai/platform/merlin-agent-builder/
- Agent Gateway for MCP: https://tray.ai/platform/agent-gateway/
- Book a demo: https://tray.ai/contact/