Skip to content
Scalekit Docs
Talk to an EngineerDashboard
DEVELOPER KIT
Tools and examples to accelerate your integration
Build with AIIntegrate auth with AI coding agents
Reference & toolingImplement auth with SDKs, REST APIs, OpenAPI specs, and Postman collections
Testing UtilitiesTest and debug auth integrations locally
RESOURCES
Guides, references, and community resources
IntegrationsConnect external identity providers and platforms
WorkflowsAutomate user lifecycle and auth events with webhooks
CookbooksImplement common patterns with step-by-step recipes
Code SamplesCopy and adapt code examples by language

Node.js SDK

Install

GitHub
npm install @scalekit-sdk/node
v2.12.0TypeScriptESM ReadyUpdated 5 days ago

Initialize

Initialize the client
import { ScalekitClient } from '@scalekit-sdk/node';


const scalekit = new ScalekitClient(
  process.env.SCALEKIT_ENVIRONMENT_URL,
  process.env.SCALEKIT_CLIENT_ID,
  process.env.SCALEKIT_CLIENT_SECRET
);


export default scalekit;

Changelog

View all releases →
v2.12.0

What's Changed

Scalekit v2.12.0 introduces encrypted-session middleware, mirroring the Python SDK’s middleware.

This release also includes a security fix by bumping axios to a more secure version. The middleware is framework-agnostic, with adapters for Express and Next.js, and includes features like transparent session refresh, full logout, and configurable local or full logout.

v2.11.0

What's Changed

  • [SK-1339] feat: typed updateLoginUserDetails response + listEventsPaginated by @AkshayParihar33 in #210
  • [SK-1357] Sanitize AxiosError to avoid leaking client_secret on token exchange failure by @claude[bot] in #209

New Contributors

Full Changelog: v2.10.0...v2.11.0

v2.8.0

Release Notes

This release introduces configurable timeouts for management APIs and tool-call APIs.

  • New timeoutMs option — timeout for management API calls (organizations, users, connections, etc.). Default: 20 seconds.
  • New toolTimeoutMs option — timeout for tool-call APIs (tools.*, actions.executeTool, actions.request), which can run longer as they call third-party providers. Default: 60 seconds.

const scalekit = new ScalekitClient(envUrl, clientId, clientSecret, {
timeoutMs: 20_000,
toolTimeoutMs: 60_000,
});

  • Calls that exceed the timeout now throw ScalekitGatewayTimeoutException instead of waiting indefinitely.
  • Invalid timeout values (zero or negative) throw an error at client creation.
  • actions.request default timeout changed from 30 to 60 seconds; it can still be overridden per call with timeoutMs.

Full Changelog: v2.7.0...v2.8.0

v2.7.0

What's Changed

  • fix(SK-819, SK-821): provider error differentiation, blind retry fix, and upsert credentials by @ravibits in #200

Full Changelog: 2.6.3...v2.7.0

2.6.3

What's Changed

  • [SK-623] chore(deps): bump 5 low-risk Node deps by @dhawani in #189
  • [SK-625] chore(deps): bump axios from 1.13.5 to 1.17.0 by @dhawani in #190
  • [SK-626] chore(deps): bump @bufbuild stack (protobuf + buf + protoc-gen-es) by @dhawani in #192
  • [SK-628] chore(deps): bump dotenv from 16.6.1 to 17.4.2 by @dhawani in #193
  • [SK-630] chore(deps): bump jest + @types/jest from 29 to 30 by @dhawani in #194
  • [SK-632] chore(deps): bump @types/node from 20 to 25 by @dhawani in #195
  • [SK-633] chore(deps): bump jose from 5 to 6 by @dhawani in #196
  • [SK-643] chore(deps): bump typescript from 5 to 6 by @dhawani in #197
  • chore: release v2.6.3 by @srinivaskarre-sk in #198

New Contributors

Full Changelog: 2.6.2...2.6.3

2.6.0

What's Changed

Full Changelog: v2.5.0...2.6.0

v2.5.0

What's Changed

  • Adds support for Agent Auth And Connected Accounts.

Full Changelog: v2.4.0...v2.5.0