Get access token

POST

/oauth2/token

Generate an access token for all other Kobble APIs.

Send this request to the Cognito host for your environment, not to the API base URL. The path below is shown without a host because this endpoint is not served from the API host.

Production: https://cognito.apikobble.net/oauth2/token

Staging: https://cognito.staging.apikobble.net/oauth2/token

Tokens are valid for 3600 seconds. The response carries no refresh token, so request a new token before the current one expires.

This endpoint and GET /customers/v1/health are the only two that require no authentication.

Request

Header Params

Body Params application/x-www-form-urlencoded

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/oauth2/token' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'grant_type=client_credentials' \
--data-urlencode 'client_id={{client_id}}' \
--data-urlencode 'scope=administrator/write' \
--data-urlencode 'client_secret={{client_secret}}'

Responses

🟢200OK

application/json

Bodyapplication/json

Example

{
    "access_token": "eyJraWQiOiJFWEFNUExFIn0.eyJzdWIiOiJleGFtcGxlIn0.EXAMPLE-SIGNATURE",
    "expires_in": 3600,
    "token_type": "Bearer"
}

Modified at 2026-09-16 03:02:46

Authorization

List all beneficiaries