Access Tokens

Access Tokens allow a developer to authenticate SDK requests on behalf of a specific Catalytic user. Each Access Token must be approved by the user on whose behalf it grants access. That approval can be done either explicitly by logging in to the Catalytic Web App and approving a specific Access Token request, or by supplying their email and password when creating a new Access Token.

For more details on creating Access Tokens or how Access Tokens are used to authenticate in the SDK, please see the preceding Authentication section.

The accessTokens client provides the following methods:

MethodDescription
getGets a specific Access Token by ID
findFetch all of your Access Tokens
createCreates a new Access Token with your email and password
Not supported for teams with SSO enabled
createWithWebApprovalFlowCreates a new Access Token to be approved via the Account page in the Catalytic Web App
Supported for all teams with or without SSO
waitForApprovalWaits for an Access Token created with createWithWebApprovalFlow to be approved in the Catalytic Web App
getApprovalUrlGets the URL that the user should be directed to to approve the Access Token created with
openUrlA helper method for desktop apps to open the token approval URL that works across Windows, OSX and Linux
revokeRevokes an Access Token so it can no longer be used

Quickstart Example

/*
 * This example demonstrates creating a new Access Token using your
 * email and password
 */
const { CatalyticClient } = require('@catalytic/sdk');

const catalytic = new CatalyticClient();

const accessToken = await catalytic.accessTokens.create('your-team', 'your-email', 'your-password', 'your-token-name');

catalytic.setAccessToken(accessToken);