Developer API
Setting Up the API Using the API API Reference
Developer

Setting Up the API

After you've been granted API access, follow these steps to begin using the Kinabase API:

  1. In the bottom-right corner of the screen, select Settings.
  2. Select the API tab from the list (note: you must be a system administrator to access this).
  3. Click + Add in the top-right corner to create a new App Registration, which is required to use the Kinabase API.
  4. Enter a Name (required) and an Description (optional) for the app.
  5. An App ID and an App Secret.will be generated. These are needed to obtain an authentication token to make API requests.

Authentication

Before making any requests to the Kinabase API, you need to authenticate by generating a token. The steps to obtain a token are as follows:

  1. Copy the App ID and App Secret from the API settings after registering your app.
  2. Send a POST request to https://app.kinabase.com/api/v1/api/v1/token with the following JSON body:
{  
    "appId": "{your-app-id}",  
    "appSecret": "{your-app-secret}"  
}
  1. If successful, you'll receive a return status 200 along with an authentication token. Cache this token, as you will need it for subsequent requests. The token is valid for 1 hour.
  2. If your token is invalidated or expires, simply generate a new one by repeating this process.