Learn about our RFC process, Open RFC meetings & more.Join in the discussion! »


1.0.4 • Public • Published

Rollbar Web API for Node

Build Status Coverage Status

A node.js wrapper for the Rollbar Web API. Rollbar already provides an SDK for node.js applications, so if you're looking to track errors and crashes, you should check that out first. Although there are plans to implement the Rollbar notifier functionalities in this project, they are not currently included.

What this package does, however, is provide you with a way to access an manipulate Rollbar account information. For example, if you want a way to programmatically look up or create new Rollbar projects and grab the relevent access tokens, this module is for you.

Included functions:


  • Invite a user to a team
  • Get information about an invitation
  • List all invitations for a team
  • Cancel a pending invitation

Items (GET, PATCH)

  • Coming soon
    • Get an item by its ID
    • Get an item by its counter
    • List all items
    • Modify an item

Items (POST)

  • Coming soon
    • Create an item


  • Coming soon
    • Get an occurrence by its ID
    • List occurrences
    • List occurrences of a specific item
    • Delete an occurrence


  • List projects in an account
  • Get information about a specific project
  • Delete a project
  • Create a project
  • List project access tokens
  • Update project access token rate limits


  • Coming soon
    • Get top recent active items
    • Get occurrence counts
    • Get activated counts


  • Get information about a specific team
  • List teams for an account
  • Create a new team
  • Delete a team
  • Check if a project is within a specific team
  • Add a project to a team
  • Remove a project from a team
  • Check if a user is part of a team
  • List team members
  • Remove a user from a team


  • Get information about a specific user


$ npm install --save


As of now, only account-level functions are included (i.e., any function requiring a project-level access token would not work under the current configuration).

Therefore, the tokens you should pass upon instantiation are the read and write tokens found in your Rollbar account settings.

var Rollbar = require('rollbar-api');
var rollbar = new Rollbar({
  read: '<account_read_token>',
  write: '<account_write_token>'

Then, you can use methods to interact directly with Rollbar API

// get a list of projects
rollbar.listProjects(function (err, res) {
  if (err) {
    return console.log(err.message);
  console.log("Array of projects", res.body);

Interacting with Responses


Callbacks will receive an error object if:

  1. Either the http request itself was unsuccessful
  2. Or the response from Rollbar was an error (http status code of >200)

Examples of the latter include attempting to make API calls with the incorrect token or trying to access information that does not exist (e.g., calling getUser() on a nonexistent user ID).

Rollbar API-type error objects have the following properties:

  name: "RollbarAPIError",
  message: "<message from Rollbar API>",
  statusCode: "<numeric http status code from Rollbar API>",
  statusMessage: "<http status message corresponding to statusCode>"

where statusCode can be any of 400, 403, 404, 413, 422, or 429. See this page for more information.


If the http request was successful and the Rollbar API processes the request, a response will be returned. All responses have the following properties:

  statusCode: 200,
  headers: {
    // http headers
  body: {
    // json-encoded reply from the API

where headers are from an http.incomingMessage instance.


View documentation here.


You can start your application with a debug environment variable to view the raw http requests (being sent through the awesome request package) like this:

NODE_DEBUG=request node app.js


You can run unit tests with mocha.


npm i rollbar-api

DownloadsWeekly Downloads






Last publish


  • avatar