Skip to content


Repository files navigation

Range Logo

Range Node.js SDK · License Twitter

Range helps teams know what’s happening, stay in sync, and actually feel like a team. It’s thoughtfully designed software that helps teams share daily check-ins, track goals, and run better meetings. So you can do your best work together.

Everything is easier in Range because it works with the tools you already use. Your tasks, documents, and code changes are already in Range, so you don’t have to enter data twice.

Find out more at


The Range Node SDK provides access to the Range API from applications written in server-side javascript.

This package makes use of Range API Keys, be careful to keep these keys secure. Avoid checking them into git repositories or leaving them in unsecured source code.


See this readme and the API docs.


npm install range-sdk --save


This package needs to be configured with an API key which you can generate by visiting your developer dashboard. The key can be passed in via the RANGE_ACCESS_KEY environment variable, or as a constructor argument.

const Range = require('range-sdk');
const rangeClient = new Range('deadbeef1234567890');

The SDK uses promises:

new Range()
  .then(resp => console.log(resp))
  .catch(err => console.error(err.message));

or you can use await:

const team = await new Range().readTeam(productTeamID);

Errors are typed; both NetworkError and APIError inherit from RangeError.

new Range()
  .findUser({ email: '' })
  .then(resp => console.log(resp))
  .catch(err => {
    if (err instanceof Range.APIError && err.code === Range.ErrorCodes.NOT_FOUND) {
      console.log('A Range user does not exist for that email');
    } else {


No releases published


No packages published