@descope/core-js-sdk

Descope JavaScript core SDK

Usage

Install the package

npm install @descope/core-js-sdk

Use it

import createSdk from '@descope/core-js-sdk';

const projectId = '<project-id>';

const sdk = createSdk({ projectId });

const loginId = 'loginId';

sdk.otp.signIn.email(loginId);

Outbound Connect

Connect to outbound applications (e.g., Google, Microsoft) to access user data from external services.

Basic Usage

// Connect to an outbound application
const response = await sdk.outbound.connect('app-id', {
  redirectUrl: 'https://your-app.com/callback',
  scopes: ['email', 'profile'],
});

// Redirect user to the returned URL
window.location.href = response.data.url;

Using External Identifier

You can pass an external identifier to map the outbound connection to an external user:

const response = await sdk.outbound.connect('app-id', {
  redirectUrl: 'https://your-app.com/callback',
  scopes: ['email', 'profile'],
  externalIdentifier: 'external-user-id-123',
});

Tenant-Specific Connections

For multi-tenant applications, you can specify tenant-level connections:

const response = await sdk.outbound.connect('app-id', {
  redirectUrl: 'https://your-app.com/callback',
  scopes: ['email', 'profile'],
  externalIdentifier: 'external-user-id-123',
  tenantId: 'tenant-123',
  tenantLevel: true,
}, 'user-session-token');