This package has been deprecated

Author message:

Moved to @pusher/platform-node

TypeScript icon, indicating that this package has built-in type declarations

0.15.0 • Public • Published


Pusher Platform SDK for Node.js.


Add pusher-platform-node to your package.json file:

  "dependencies": {
    "pusher-platform-node": "~0.15.0"


In order to access Pusher Platform, first instantiate an Instance object. It takes the following arguments:

var PusherPlatform = require("pusher-platform-node");
var pusherPlatform = new PusherPlatform.Instance({
  locator: '',
  serviceName: '',
  serviceVersion: '',
  key: '',
  sdkInfo: new PusherPlatform.SDKInfo({
    productName: '',
    version: '',
  • locator is unique to an app developers' instance - they get that from the dashboard. The service SDKs will need to relay that down. Same for the key.
  • serviceName and serviceVersion should come from the service SDK itself. They can be hardcoded there. Think feeds and v1.
  • sdkInfo is used to provide product and SDK version information, via headers, to the platform

It is also possible to specify host and port. This will override the cluster value that is encoded in the instance and allow you to connect to a development or testing server.


Instance objects provide an authenticate method, which can be used in controllers to build authentication endpoints. Authentication endpoints issue access tokens used by Pusher Platform clients to access the API.

Calling authenticate will return an object that has the following shape:

  access_token: 'adsasd',
  token_type: 'bearer',
  expires_in: 86400

If you want to have a refresh token returned as well, then you need to call authenticateWithRefreshToken. That will return an object with the following shape:

  access_token: 'adsasd',
  token_type: 'bearer',
  expires_in: 86400,
  refresh_token: 'cxacsac'

Make sure you authenticate the user before issuing access tokens.

  • authenticatePayload param is essentially object of type AuthenticatePayload. The object must have the following format: (please note that if you using one of our client libraries they will handle this format for you)
type AuthenticatePayload {
  grant_type: string;
  refresh_token?: string;
let authenticatePayload = {
  grant_type: 'client_credentials'
let authOptions = {
  userId: 'zan',
  serviceClaims: {
    claim1: 'sdsdsd'
let authResponse = app.authenticate(authenticatePayload, authOptions);

Where the authResponse is an object containing your access token (and refresh token, if you called authenticateWithRefreshToken):

let = authResponse: {
  access_token: 'adsasd',
  token_type: 'bearer',
  expires_in: 86400,

A custom token expiry value can be set by including a tokenExpiry key in the authOptions object.

let authOptions = {
  userId: 'zan',
  serviceClaims: {
    claim1: 'sdsdsd'
  tokenExpiry: (10 * 60),

Request API

Instance objects provide a low-level request API, which can be used to contact services running on the Pusher Platform.

  method: "POST",
  path: 'feeds/playground',
  headers: {
    'Content-Type': 'application/json',
  body: { items: ['test'] },
}).then(function(response) {
  return pusher.readJSON(response);
}).then(function(body) {
}).catch(function(e) {
  if (instanceof pusher.ErrorResponse) {
  } else {

Issues, Bugs, and Feature Requests

Feel free to create an issue on GitHub if you find anything wrong. Please use the existing template. If you wish to contribute, please make a pull request.


pusher-platform-node is released under the MIT license. See LICENSE for details.




Package Sidebar


npm i pusher-platform-node

Weekly Downloads






Unpacked Size

41.7 kB

Total Files


Last publish


  • jeremy.goldstein
  • fbenevides
  • marcelcorso
  • pushercom