Authentication

Request

curl --location --request POST 'https://api.butlr.io/api/v2/login' \
--header 'Content-Type: application/json' \
--data-raw '{
    "username": "[email protected]",
    "password": "your_password"
}'

Response

{
    "access_token": "your_access_token",
    "refresh_token": "your_refresh_token",
    "id_token": "your_id_token",
    "scope": "your_scopes",
    "expires_in": 1000,
    "token_type": "Bearer"
}

How to create your client credentials

  1. Go to the Butlr Web App.

  2. Sign in using your username and password.

  3. Click the expandable menu (v) in the top navigation bar (upper right corner) and select Account Settings.

  1. Navigate to the API tokens tab.

  2. Click the Create token button.

  3. Enter a Name and a Description, then click Create.

  4. A dialog box will display your Client ID and Client Secret.

  • ⚠️ Important: Be sure to copy and securely store these credentials. For security reasons, they will not be shown again after you close the dialog.

Request

curl --location --request POST 'https://api.butlr.io/api/v2/clients/login' \
--header 'Content-Type: application/json' \
--data '{
    "client_id": "your_client_id",
    "client_secret": "your_client_secret",
    "audience": "https://butlrauth/",
    "grant_type": "client_credentials"
}'

Response

{
    "access_token": "your_access_token",
    "scope": "your_scopes",
    "expires_in": 1000,
    "token_type": "Bearer"
}

Last updated