1.14.4 • Public • Published

Microsoft Azure Cosmos DB Node.js SDK

This project provides Node.js SDK library for SQL API of Azure Cosmos DB Database Service. This project also includes samples, tools, and utilities.

Useful links:



Install Node.js and npm

Node SDK can be consumed in two ways.

Install Core Module Published to NPM

The core module uses the callbacks model for responses, exposed through the DocumentClient

npm install documentdb

Install Core Module From Github

  1. Clone Azure/azure-documentdb-node repository Please clone the source and tests from

  2. Install documentdb

     npm install azure-documentdb-node\source


To use the SDK, first create an account and follow tutorial.


When connecting to the emulator from the SDK, SSL verification is disabled.

Follow these instructions to run the tests locally.



  1. Clone Azure/azure-documentdb-node repository Please clone the source and tests from

  2. Install Node.js and npm

  3. Install mocha package globally

     npm install -g mocha

Running the tests

Using your command-line tool, from the root of your local copy of azure-documentdb-node repository: (If you are contributing changes and submitting PR then you need to ensure that you run the tests against your local copy of the source, and not the published npm package.)

  1. Remove documentdb, if previously installed

     npm remove documentdb
  2. Install documentdb

     npm install source
  3. Change to test directory

     cd source\test
  4. Run the tests

     mocha -t 0 -R spec

If you just want to run the tests against the published npm package then skip steps #1 & #2 proceed directly to step #3


Hello World using Callbacks via the Core Module

var DocumentClient = require('documentdb').DocumentClient;
var host = "[hostendpoint]";                     // Add your endpoint
var masterKey = "[database account masterkey]";  // Add the masterkey of the endpoint
var client = new DocumentClient(host, {masterKey: masterKey});
var databaseDefinition = { id: "sample database" };
var collectionDefinition = { id: "sample collection" };
var documentDefinition = { id: "hello world doc", content: "Hello World!" };
client.createDatabase(databaseDefinition, function(err, database) {
    if(err) return console.log(err);
    console.log('created db');
    client.createCollection(database._self, collectionDefinition, function(err, collection) {
        if(err) return console.log(err);
        console.log('created collection');
        client.createDocument(collection._self, documentDefinition, function(err, document) {
            if(err) return console.log(err);
            console.log('Created Document with content: ', document.content);
            cleanup(client, database);
function cleanup(client, database) {
    client.deleteDatabase(database._self, function(err) {
        if(err) console.log(err);

Youtube Videos

Getting started with Node.js SDK:

Azure Demo: Getting started with Document Node.js SDK

Need Help?

Be sure to check out the Microsoft Azure Developer Forums on MSDN or the Developer Forums on Stack Overflow if you have trouble with the provided code.

Contribute Code or Provide Feedback

If you would like to become an active contributor to this project please follow the instructions provided in Azure Projects Contribution Guidelines.

If you encounter any bugs with the library please file an issue in the Issues section of the project.


npm i documentdb-pr-223

DownloadsWeekly Downloads






Unpacked Size

945 kB

Total Files


Last publish


  • igorklopov