Authentication

You'll need to authenticate your requests to access any of the endpoints in the Collctiv API. In this guide, we'll look at how authentication works.

Bearer token

To authenticate with the Collctiv API a Bearer token is required. When establishing a connection, you will need your API token — you will find it in the Collctiv dashboard under API settings. Here's how to add the token to the request header using cURL:

curl https://api.collctiv.com/v1/customers \
  -H "Authorization: Bearer {token}"

Always keep your token safe and reset it if you suspect it has been compromised.

You can create more than one token, each token can be assigned different permissions and we encourage that each token is given only the permissions required. When creating a token it will be displayed to you one time only. please securely take a note of the token as it will not be retrievable after being shown.