Getting Started

Who is this guide for?

This guide is designed for developers and technical users who want to integrate their applications with CatalystOne using our APIs.

  • Users will learn the basics of authentication, setting up a client, and making a successful test call.

  • Existing customers with an application can jump directly to the client management and API reference sections.

Where relevant, links are provided to detailed documentation.

 

Client credentials flow

Step 1: Set Up Your API Client

To be able to integrate with your CatalystOne application using the client credentials flow (typically a machine-to-machine integration) you must fist set up an API Client and corresponding credentials. See detailed description for how to set these up here.

Step 2: Authentication

Request a token from the Authentication service. See details for how you use you client id and client secret to request a token here.

Step 3: Make API Request

Make a request to the corresponding API using the token acquired in step 2. For example:

curl --location 'https://api.catalystone.io/webhooks/eventTypes' \
--header 'Authorization: Bearer <Token>'

Note: <Token> this means, the JWT token acquired in the previous step.

 

Authorization code flow

Step 1: Set Up Your App

To be able to integrate with you CatalysOne application from an application or context where actions are performed on behalf of a logged in user you must first set up an App. See detailed description for how to set this up here.

Step 2:

Create you fantastic app and log in user as described here.

 

Next Steps