WorkOS Docs Homepage
SDKs
API referenceDashboardSign In
SDKs

Node.js SDK

github.com
workos/workos-node
176 Stars
46 Forks
74 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

December 24, 2025

v7.78.0

Latest
December 24, 2025

What's Changed

  • Add authenticationMethod to sealed session by @cmatheson in #1417
  • add context7.json to repo by @nicknisi in #1421
  • feat: enable npm Trusted Publishers by @nicknisi in #1422
  • Add support for feature flags management API by @stanleyphu in #1420

Full Changelog: v7.77.0...v7.78.0

December 4, 2025

v7.77.0

December 4, 2025

What's Changed

  • Add workos.pipes.getAccessToken by @dandorman in #1394

Full Changelog: v7.76.0...v7.77.0

December 3, 2025

v7.76.0

December 3, 2025

What's Changed

  • Add roles to directory user & profile by @kendallstrautman in #1401
  • Bump version to v7.76.0 by @kendallstrautman in #1410

Full Changelog: v7.75.1...v7.76.0

December 2, 2025

v7.75.1

December 2, 2025

What's Changed

  • Add randomUUID to CryptoProvider for edge runtime compatibility by @nicknisi in #1404

Full Changelog: v7.75.0...v7.75.1

December 1, 2025

v7.75.0

December 1, 2025

What's Changed

  • Add missing authentication methods by @cmatheson in #1405
November 24, 2025

v7.74.2

November 24, 2025

What's Changed

  • Export vault interfaces by @kendallstrautman in #1399
  • Bump 7.74.2 by @kendallstrautman in #1400

Full Changelog: v7.74.1...v7.74.2

November 21, 2025

v7.74.1

November 21, 2025

What's Changed

  • Expose interfaces for feature flags by @davidcornu in #1395
  • Update version to v7.74.1 by @stanleyphu in #1396

New Contributors

  • @davidcornu made their first contribution in #1395

Full Changelog: v7.74.0...v7.74.1

November 21, 2025

v7.74.0

November 21, 2025

What's Changed

  • Default to adding idempotecy-key to audit-logs/events if not present by @swaroopAkkineniWorkos in #1383
  • Add ability to resend invitation by @antn in #1387
  • Add passkey authentication events by @ericroberts in #1392

New Contributors

  • @swaroopAkkineniWorkos made their first contribution in #1383

Full Changelog: v7.73.0...v7.74.0

November 13, 2025

v7.73.0

November 13, 2025
  • Add argon2 to PasswordHashType interface
November 6, 2025

v8.0.0-rc.3

Pre-release
November 6, 2025

What's Changed

  • Remove dependency on pluralize by @lucasmotta in #1379
  • [v8] Replace leb and qs deps with vanilla implementations by @nicknisi in #1382

Full Changelog: v7.72.2...v8.0.0-rc.3

November 5, 2025

v7.72.2

November 5, 2025

What's Changed

  • Add api-keys widget scope by @ajworkos in #1377
  • v7.72.2 by @ajworkos in #1378

Full Changelog: v7.72.1...v7.72.2

October 29, 2025

v7.72.1

October 29, 2025

What's Changed

  • Use retryable HTTP requests for Vault API by @hexedpackets in #1375

Full Changelog: 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 #1373
  • add convex conditional export by @erquhart in #1372

New Contributors

  • @erquhart made their first contribution in #1372

Full Changelog: 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 #1369
  • [v8] Add runtime analytics to User-Agent string by @nicknisi in #1293

Full Changelog: 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 (#1361)
  • Added locale to user (#1363)
  • Added GET /user_management/users/:id/feature-flags support (#1364)

Full Changelog: 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 #1358
  • Bump version to 7.70.0 by @csrbarber in #1359

New Contributors

  • @csrbarber made their first contribution in #1358

Full Changelog: 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 #1348
  • Add timeout to WorkOSOptions for http client requests by @nave91 in #1351
  • Bump version to 7.69.2 by @nave91 in #1353

New Contributors

  • @nave91 made their first contribution in #1351

Full Changelog: 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 #1347

Full Changelog: 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 #1345

Full Changelog: 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 (#1341)
  • Added invitation.accepted and invitation.revoked events (#1343)

Full Changelog: 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 #1337

Full Changelog: 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 #1335

Full Changelog: 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 #1331
  • Increase autoPagination delay from 250ms to 350ms by @heatherfaerber in #1330

New Contributors

  • @chaance made their first contribution in #1331
  • @heatherfaerber made their first contribution in #1330

Full Changelog: 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 #1328
  • v7.65.0 by @stanleyphu in #1329

Full Changelog: 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 #1326
  • v7.64.0 by @stanleyphu in #1327

Full Changelog: 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 #1323
  • Change deleteOrganizationDomain method name to delete to match other methods by @ajworkos in #1324
  • v7.63.0 by @ajworkos in #1325

Full Changelog: 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 #1320
  • Bump version to 7.62.1 by @atainter in #1321

Full Changelog: v7.62.0...v7.62.1

July 23, 2025

v7.62.0

July 23, 2025

What's Changed

  • Added userManagement.listSessions by @cmatheson in #1316

Full Changelog: 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 #1313
  • Bump version to 7.61.0 by @atainter in #1314

Full Changelog: 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 (#1308)

Full Changelog: v.7.59.0...v7.60.0