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 the Access Token grants access. That approval can be done either explicitly by logging in to the Catalytic Web App and approving a specific token request, or by supplying their email and password when creating a new 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 Token
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
getApprovalUrlGets the URL that the user should be directed to to approve the User
Access Token created with createWithWebApprovalFlow
revokeRevokes a User Access Token so it can no longer be used

Quickstart Example

/*
 * This example demonstrates creating a new Access Token using your
 * email and password
 */
import org.catalytic.sdk.CatalyticClient;
import org.catalytic.sdk.entities.AccessToken;

public class Program {
  
    public static void main(String[] args) throws Exception {
				
      	// Create and initialize the Catalytic SDK Client
        CatalyticClient catalytic = new CatalyticClient();
      
      	AccessToken accessToken = catalytic.accessTokens().create("your-team.pushbot.com", "your-email", "your-password");      
    }
}