WorkOS Docs Homepage
SDKs
API referenceDashboardSign In
SDKs

Node.js SDK

github.com
workos/workos-node
168 Stars
43 Forks
71 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

October 29, 2025

v7.72.1

Latest
October 29, 2025

What's Changed

  • Use retryable HTTP requests for Vault API by @hexedpackets in https://github.com/workos/workos-node/pull/1375

Full Changelog: https://github.com/workos/workos-node/compare/v7.72.0...v7.72.1

October 28, 2025

v7.72.0

October 28, 2025

What's Changed

  • Add apiKeys.validateApiKey method by @nholden in https://github.com/workos/workos-node/pull/1373
  • add convex conditional export by @erquhart in https://github.com/workos/workos-node/pull/1372

New Contributors

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

Full Changelog: https://github.com/workos/workos-node/compare/v7.71.0...v7.72.0

October 15, 2025

v8.0.0-rc.1

Pre-release
October 15, 2025

What's Changed

  • Default PaginationOptions on AutoPaginatable by @nicknisi in https://github.com/workos/workos-node/pull/1369
  • [v8] Add runtime analytics to User-Agent string by @nicknisi in https://github.com/workos/workos-node/pull/1293

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

October 10, 2025

v7.71.0

October 10, 2025

What's Changed

  • Added Salesforce OAuth as an authentication provider (https://github.com/workos/workos-node/pull/1361)
  • Added locale to user (https://github.com/workos/workos-node/pull/1363)
  • Added GET /user_management/users/:id/feature-flags support (https://github.com/workos/workos-node/pull/1364)

Full Changelog: https://github.com/workos/workos-node/compare/v7.70.0...v7.71.0

September 18, 2025

v7.70.0

September 18, 2025

What's Changed

  • Add multiple roles support by @csrbarber in https://github.com/workos/workos-node/pull/1358
  • Bump version to 7.70.0 by @csrbarber in https://github.com/workos/workos-node/pull/1359

New Contributors

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

Full Changelog: https://github.com/workos/workos-node/compare/v7.69.2...v7.70.0

September 3, 2025

v7.69.2

September 3, 2025

What's Changed

  • Fix GetTokenOptions[scopes] type by @chaance in https://github.com/workos/workos-node/pull/1348
  • Add timeout to WorkOSOptions for http client requests by @nave91 in https://github.com/workos/workos-node/pull/1351
  • Bump version to 7.69.2 by @nave91 in https://github.com/workos/workos-node/pull/1353

New Contributors

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

Full Changelog: https://github.com/workos/workos-node/compare/v7.69.1...v7.69.2

August 25, 2025

v7.69.1

August 25, 2025

What's Changed

  • Add provider_query_params to getAuthorizationUrl method by @jonatascastro12 in https://github.com/workos/workos-node/pull/1347

Full Changelog: https://github.com/workos/workos-node/compare/v7.69.0...v7.69.1

August 25, 2025

v7.69.0

August 25, 2025

What's Changed

  • Add providerScopes and oauthTokens support to SSO API by @jonatascastro12 in https://github.com/workos/workos-node/pull/1345

Full Changelog: https://github.com/workos/workos-node/compare/v7.68.0...v7.69.0

August 20, 2025

v7.68.0

August 20, 2025

What's Changed

  • Added widgets:domain-verification:manage to WidgetScope (https://github.com/workos/workos-node/pull/1341)
  • Added invitation.accepted and invitation.revoked events (https://github.com/workos/workos-node/pull/1343)

Full Changelog: https://github.com/workos/workos-node/compare/v7.67.0...v7.68.0

August 15, 2025

v7.67.0

August 15, 2025

What's Changed

  • add widgets:sso:manage scope by @cmatheson in https://github.com/workos/workos-node/pull/1337

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

August 11, 2025

v7.66.1

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