Authentication

Authenticate with the Atlas CRM API

In order to work with the API you will need an access token. You can obtain an access token by creating a client secret and client id through the API tokens UI in the Atlas CRM settings.

You can find the API tokens by navigating to settings in the top right corner of the app and then selecting the dropdown item API tokens.

Note: API tokens will always get admin privileges

After creating a new API token you will be presented with 2 fields: client secret and client id . You will need both to fetch an access token with the following command:

Fetch with request header

You will need to base64 encode your "YOURCLIENTID:YOURCLIENTSECRET" and perform a POST request to the token endpoint using basic authentication.

curl "https://atlascrm.avisi-apps.com/api/1.0/oauth/token" \
    -H "Authorization: Basic BASE64ENCODED" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -d "grant_type=client_credentials"

Notice that the grant_type should be specified inside the body of the request. If you are not using curl make sure to also set the Content-Type header to application/x-www-form-urlencoded .

Fetch with request body

You can also make a POST request using only the body. If you are not using curl make sure to also set the Content-Type header to application/x-www-form-urlencoded .

curl "https://atlascrm.avisi-apps.com/api/1.0/oauth/token" \ 
    -H "Content-Type: application/x-www-form-urlencoded" \
    -d "grant_type=client_credentials" \
    -d "client_id=YOURCLIENTID" \
    -d "client_secret=YOURCLIENTSECRET"

This token is valid for 1 hour and you will need to fetch a new bearer token with your client secret and client id to get a new one.

You can now query our API with the authorization header "Bearer YOUR_ACCESS_TOKEN".

Last updated