WorkOS Docs Homepage
SDKs
API referenceDashboardSign In
SDKs

Node.js SDK

github.com
workos/workos-node
155 Stars
39 Forks
67 Contributors
github.com
Official Node.js SDK for interacting with the WorkOS API.

Installation

JavaScript

Beta Versions

Certain WorkOS features may be available only in the beta version of the SDK. Beta versions have the -beta.* suffix, for example, 3.2.0-beta.1. For more information on how to use the beta versions, refer to the README in the GitHub repository.

Releases

August 11, 2025

v7.66.1

Latest
August 11, 2025

What's Changed

  • Fix feature flags endpoint URL by @nicknisi in https://github.com/workos/workos-node/pull/1335

Full Changelog: https://github.com/workos/workos-node/compare/v7.66.0...v7.66.1

August 8, 2025

v7.66.0

August 8, 2025

What's Changed

  • Remove Node version manager configs by @chaance in https://github.com/workos/workos-node/pull/1331
  • Increase autoPagination delay from 250ms to 350ms by @heatherfaerber in https://github.com/workos/workos-node/pull/1330

New Contributors

  • @chaance made their first contribution in https://github.com/workos/workos-node/pull/1331
  • @heatherfaerber made their first contribution in https://github.com/workos/workos-node/pull/1330

Full Changelog: https://github.com/workos/workos-node/compare/v7.65.0...v7.66.0

August 5, 2025

v7.65.0

August 5, 2025

What's Changed

  • Add pagination support to listOrganizationFeatureFlags by @stanleyphu in https://github.com/workos/workos-node/pull/1328
  • v7.65.0 by @stanleyphu in https://github.com/workos/workos-node/pull/1329

Full Changelog: https://github.com/workos/workos-node/compare/v7.64.0...v7.65.0

August 5, 2025

v7.64.0

August 5, 2025

What's Changed

  • Add GET /organizations/:orgId/feature-flags support by @stanleyphu in https://github.com/workos/workos-node/pull/1326
  • v7.64.0 by @stanleyphu in https://github.com/workos/workos-node/pull/1327

Full Changelog: https://github.com/workos/workos-node/compare/v7.63.0...v7.64.0

August 1, 2025

v7.63.0

August 1, 2025

What's Changed

  • Expose delete endpoint for organization_domains - DAAP-1752 by @ajworkos in https://github.com/workos/workos-node/pull/1323
  • Change deleteOrganizationDomain method name to delete to match other methods by @ajworkos in https://github.com/workos/workos-node/pull/1324
  • v7.63.0 by @ajworkos in https://github.com/workos/workos-node/pull/1325

Full Changelog: https://github.com/workos/workos-node/compare/v7.62.1...v7.63.0

July 25, 2025

v7.62.1

July 25, 2025

What's Changed

  • Raise ParseError if non-200 response returns invalid JSON by @atainter in https://github.com/workos/workos-node/pull/1320
  • Bump version to 7.62.1 by @atainter in https://github.com/workos/workos-node/pull/1321

Full Changelog: https://github.com/workos/workos-node/compare/v7.62.0...v7.62.1

July 23, 2025

v7.62.0

July 23, 2025

What's Changed

  • Added userManagement.listSessions by @cmatheson in https://github.com/workos/workos-node/pull/1316

Full Changelog: https://github.com/workos/workos-node/compare/v7.61.0...v7.62.0

July 18, 2025

v7.61.0

July 18, 2025

What's Changed

  • Add ParseError to include rawBody and requestID for debugging purposes by @atainter in https://github.com/workos/workos-node/pull/1313
  • Bump version to 7.61.0 by @atainter in https://github.com/workos/workos-node/pull/1314

Full Changelog: https://github.com/workos/workos-node/compare/v7.60.0...v7.61.0

July 16, 2025

v7.60.0

July 16, 2025

What's Changed

  • Added support for provider_query_params option on getAuthorizationUrl (https://github.com/workos/workos-node/pull/1308)

Full Changelog: https://github.com/workos/workos-node/compare/v.7.59.0...v7.60.0

July 8, 2025

v7.59.0

July 8, 2025
  • Added 'prompt' parameter to GetAuthorizationUrl
July 9, 2025

v7.58.0

July 9, 2025

What's Changed

  • add organization_domain created/updated/deleted events by @ajworkos in https://github.com/workos/workos-node/pull/1300

Full Changelog: https://github.com/workos/workos-node/compare/v7.57.0...v7.58.0

June 27, 2025

v7.57.0

June 27, 2025

What's Changed

  • Add authenticateWithCodeAndVerifier method for strict PKCE enforcement by @nicknisi in https://github.com/workos/workos-node/pull/1297

Full Changelog: https://github.com/workos/workos-node/compare/v7.56.0...v7.57.0

June 26, 2025

v7.56.0

June 26, 2025

What's Changed

  • Add session.revoked event: https://github.com/workos/workos-node/pull/1294

Full Changelog: https://github.com/workos/workos-node/compare/v7.55.0...v7.56.0

June 20, 2025

v7.55.0

June 20, 2025

What's Changed

  • Add feature flags to parsed access-token results by @kkajla12 in https://github.com/workos/workos-node/pull/1295

Full Changelog: https://github.com/workos/workos-node/compare/v7.54.0...v7.55.0

June 12, 2025

v8.0.0-beta.2

Pre-release
June 12, 2025

Full Changelog: https://github.com/workos/workos-node/compare/v8.0.0-beta.1...v8.0.0-beta.2

June 11, 2025

v8.0.0-beta.1

Pre-release
June 11, 2025

Full Changelog: https://github.com/workos/workos-node/compare/v7.54.0...v8.0.0-beta.1

June 5, 2025

v7.54.0

June 5, 2025

What's Changed

  • Export Identity/IdentityResponse interfaces (#1291)

Full Changelog: https://github.com/workos/workos-node/compare/v7.53.0...v7.54.0

May 30, 2025

v7.53.0

May 30, 2025

What's Changed

  • Renamed and deprecated the AuthorizationURLOptions interfaces (https://github.com/workos/workos-node/pull/1282)
  • Added support for provider_scopes query param (https://github.com/workos/workos-node/pull/1288)

Full Changelog: https://github.com/workos/workos-node/compare/v7.52.0...v7.53.0

May 26, 2025

v7.52.0

May 26, 2025

What's Changed

  • adds organization_name to ListOrganizationMemberships response #1285
May 22, 2025

v7.51.0

May 22, 2025

What's Changed

  • adds email to UpdateUserOptions #1273
  • deserializes FGA warnings #1280
May 16, 2025

v7.50.1

May 16, 2025

What's Changed

  • Remove duplicate crypto files by @nicknisi in https://github.com/workos/workos-node/pull/1268
  • Fix Vault crypto implementation for edge runtime compatibility by @nicknisi in https://github.com/workos/workos-node/pull/1269
  • Allow null value metadata by @kaylagordon in https://github.com/workos/workos-node/pull/1274
  • v7.50.1 by @nicknisi in https://github.com/workos/workos-node/pull/1275

New Contributors

  • @kaylagordon made their first contribution in https://github.com/workos/workos-node/pull/1274

Full Changelog: https://github.com/workos/workos-node/compare/v7.50.0...v7.50.1

May 5, 2025

v7.50.0

May 5, 2025

What's Changed

  • Support optional authenticated data in local encrypt/decrypt by @hexedpackets in https://github.com/workos/workos-node/pull/1264

Full Changelog: https://github.com/workos/workos-node/compare/v7.49.0...v7.50.0

May 2, 2025

v7.49.0

May 2, 2025

What's Changed

  • Deprecate context option on getAuthorizationUrl by @nholden in https://github.com/workos/workos-node/pull/1263
  • feat: add authentication.radar_risk_detected event by @faroceann in https://github.com/workos/workos-node/pull/1265

Full Changelog: https://github.com/workos/workos-node/compare/v7.48.0...v7.49.0

April 25, 2025

v7.48.0

April 25, 2025

What's Changed

  • Add customAttributes field to SSO Profile (#1261)

Full Changelog: https://github.com/workos/workos-node/compare/v7.47.0...v7.48.0

April 21, 2025

v7.47.0

April 21, 2025

Full Changelog: https://github.com/workos/workos-node/compare/v7.46.0...v7.47.0

Full Changelog: https://github.com/workos/workos-node/compare/v7.46.0...v7.47.0

What's Changed

  • Add organizationId to organization domain by @ajworkos in https://github.com/workos/workos-node/pull/1259
  • version 7.47.0 by @ajworkos in https://github.com/workos/workos-node/pull/1260

New Contributors

  • @ajworkos made their first contribution in https://github.com/workos/workos-node/pull/1259

Full Changelog: https://github.com/workos/workos-node/compare/v7.46.0...v7.47.0

April 9, 2025

v7.46.0

April 9, 2025

What's Changed

  • Added password_reset.succeeded event type (https://github.com/workos/workos-node/pull/1256)

Full Changelog: https://github.com/workos/workos-node/compare/v7.45.0...v7.46.0

March 27, 2025

v7.45.0

March 27, 2025

What's Changed

  • Rename Vault secrets to objects by @hexedpackets in https://github.com/workos/workos-node/pull/1247

Full Changelog: https://github.com/workos/workos-node/compare/v7.44.0...v7.45.0

March 21, 2025

v7.44.0

March 21, 2025

What's Changed

  • Add email standard attribute to DirectoryUser (#1223)
  • Mark emails, job_title, and username standard attributes as deprecated. Enable the equivalent auto-mapped custom attributes instead (#1223)

Full Changelog: https://github.com/workos/workos-node/compare/7.43.1...v7.44.0

March 21, 2025

7.43.1

March 21, 2025

What's Changed

  • Make the scopes field optional by @lucasmotta in https://github.com/workos/workos-node/pull/1243

New Contributors

  • @lucasmotta made their first contribution in https://github.com/workos/workos-node/pull/1243

Full Changelog: https://github.com/workos/workos-node/compare/v7.43.0...7.43.1

March 19, 2025

v7.43.0

March 19, 2025

What's Changed

  • Add metadata to organizations and users from https://github.com/workos/workos-node/pull/1241

Full Changelog: https://github.com/workos/workos-node/compare/v7.42.0...v7.43.0