Creating an App

Learn how to register your app, set up your API key and authenticate with the Kinabase API

Getting Started

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

Access API Settings
Navigate to Settings, and select API in the left-hand menu. If you cannot see the API tab, you may need to request access from our support team.
Create App Registration
Click + Add in the top-right corner to create a new App Registration, which is required to use the Kinabase API.
Enter App Details
Enter a Name (required) and a Description (optional) for the app.
Get Credentials
An App ID and an App Secret will be generated. These are needed to obtain an authentication token to make API requests.

Security Note Keep your App Secret secure and never expose it in client-side code. It should only be used in secure server-side applications.

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:

Copy Credentials

Copy the App ID and App Secret from the API settings after registering your app.

Request Authentication Token

Send a POST request to https://app.kinabase.com/api/v1/token with the following JSON body:

{
  "appId": "{your-app-id}",
  "appSecret": "{your-app-secret}"
}

Use the Token

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.

Token Renewal

If your token is invalidated or expires, simply generate a new one by repeating this process.

Best Practice

Implement token caching and automatic renewal in your application to maintain a seamless connection to the API.