API Reference

Authenticating to the REST API

About authentication

Many REST API endpoints require authentication.

To authenticate your request, you will need to provide an authorization token with the required scopes or permissions. There a few different ways to get a token: You can create an Access Token, or use the API to generate a User Token.

For more information on creating tokens, see Introduction to Access Control

After creating a token, you can authenticate your request by sending the token in the Authorization header of your request. For example, in the fallowing request, replace {TOKEN with a reference to your token:

curl --request GET  
--url "https://api.pillarshub.com/api/v1/Customers">
--header "Authorization: Bearer {TOKEN}"

Failed limits

If you try to use a REST API endpoint without a token or with a token that has insufficient permissions, you will receive a 401 Unauthorized response.

After detecting several requests with invalid credentials within a short period, the API will temporarily reject all authentication attempts (including ones with valid credentials) with a 401 Unauthorized response.