Authorisation

To request access to the API please e-mail us.

For each application you are accessing the API from, we will provide you with a client_id and client_secret.

Read more about securing your API keys here.

Authorisation

You can execute a client credentials exchange to get an access token for Liveforce API. Here is a curl example, replace the values for client_id and client_secret with the keys we have provided. This is a post request so implement it in whichever way is appropriate for your application.

Recommended api endpoint is now https://auth.liveforce.co - those keys can be managed in Admin App, if API module is enabled.

If you owns Auth0 key - you should use appropriate domain and request. Consider switching to our Auth IAM service, as Auth0 will be removed in the future. Consult with Support team for more details.

Audience: https://admin.liveforce.co/ (for Auth0 only)

Grant type: client_credentials

Get auth token cURL

curl --request POST \
  -d "client_id=CLIENT_ID" \
  -d "client_secret=CLIENT_SECRET" \
  -d "grant_type=client_credentials" \
  "https://auth.liveforce.co/realms/liveforce/protocol/openid-connect/token"

Auth0 cURL (deprecated)

curl --request POST \
  --url https://liveforce.eu.auth0.com/oauth/token \
  --header 'content-type: application/json' \
  --data '{"client_id":"SJB58bQRGYv2yeTYxk9fWT1BGZMT4UiU","client_secret":"kkr2565upfSVl6f7Gq9aRt8vOQlf4beUgc-fihhLiJRbKLxrVAH1OUt6CN_xLTJMf","audience":"https://admin.liveforce.co/","grant_type":"client_credentials"}'

Response

cURL

{
  "access_token": "eyJhbGckkOiJSUzI1NiIsInRfcCI6IkpXVCIsImtpZCI6IkxvZjZpRm9EbWlGWHctSzA5Nkd4MyJ9.eyJodHRwczovL3N0YWdpbmcubGl2ZWZvcmNlLmNvL3Byb3h5L2NvbXBhbnktaWQiOiI0OTIiLCJpc3MiOiJodHRwczovL2xpdmVmb3JjZS5ldS5hdXRoMC5jb20vIiwic3ViIjoiU0pCNThiUVJHWXYyeWVUWXhHTEhXVDFCR1pNVDRVaVVAY2xpZW50cyIsImF1ZCI6Imh0dHBzOi8vc3RhZ2luZy5saXZlZm9yY2UuY28vcHJveHkvIiwiaWF0IjoxNjM1NzIyODMxLCJleHAiOjE2MzU4MDkyMzEsImF6cCI6IlNKQjU4YlFSR1l2MnllVFl4R0xIV1QxQkdaTVQ0VWlVIiwic2NvcGUiOiJyZWFkOnBheW1lbnRfcmVwb3J0cyByZWFkOmNvbXBhbnlfY3Jld19kYXRhIHdyaXRlOmNvbXBhbnlfY3Jld19kYXRhIiwiZ3R5IjoiY2xpZW50LWNyZWRlbnRpYWxzIn0.NfgsQYdlZyaoPl5g9spoU1SodCVX2SacmmIFzXAnvh3x7WKTFYiI7wWNAjHFzVtjelpAFYp8KDyMDvVptzxae_AtG8F05fp8ro-DfNlTE4BfP-bXOfnIs8IPk7AmsNWW7Mf3A9YkzbIGqiqYse7Ks5MjkgMpceuRT8m54wlFmfyb3Evq3oSNTVgy0NwSJl4lbB6cPSVVsD33-ilnzwRAd0bYic7MNZHJZilL-YdKBeB8QcNLtLV-ROCgQviFQIRD6vvvdbWk9GHrCXEBsaVc4ma_C5o0najofNXPsvawDaFiwuoHS5Acouq8BSPGozFd-FsYDa5toxKcrNEpxkhKxQ",
  "token_type": "Bearer"
}

Sending the token to the API

You can use this bearer token with an Authorization Header in your request to obtain authorised access to your API.

Base for the API is: https://api.liveforce.co

cURL

curl --request GET \
  --url https://api.liveforce.co/[api-endpoint] \
  --header 'authorization: Bearer eydhbGciOiJSUzI1NiIsInR5cCI6IapXVCIsImtpZCI6IkxvZjZpRm9EbWlGWHctSzA5Nkd4MyJ9.eyJpc3MiOiJodHRwczovL2xpdmVmb3JjZS5ldS5hdXRoMC5jb20vIiwic3ViIjoiNWtHMm5zYjVJVXpsdkRhb0VMbW1yY1FLa24yUkRmQ3NAY2xpZW50cyIsImF1ZCI6Imh0dHBzOi8vc3RhZ2luZy5saXZlZm9yY2UuY28vcHJveHkvIiwiaWF0IjoxNjM1NzI3NDE0LCJleHAiOjE2MzU4MTM4MTQsImF6cCI6IjVrRzJuc2I1SVV6bHZEYW9FTG1tcmNRS2tuMlJEZkNzIiwiZ3R5IjoiY2xpZW50LWNyZWRlbnRpYWxzIn0.CCckVGIEC4BtBxL_WOuCCkNnqbPveNGyK9sG_Yepwz2QxtQkXZnJZN9eowLl5XnQ5rf6gQxu0-VP_a1e8mbNYGEW54N3-F6abVUBzWSIez4-_Nku4dBxgcgtl6KnD-cJs4KrQzWOKp2vx3VYe8BjO5mnhjeFcbES_a47dXXyrLoKjwkgmy0OwGvHBzKSxE-FMwQOQ-AFUoGPZwBJ16edGJ3bbDMBZNv15JxovOPtdwvNTJnWckkX8335d3wxCTIjqXY60LUIi_LW3QUi7ilQr4Qdb45r5EVORo5vlanF9kLHz0H_e3au0FDigWKN5CgdS-Uki9PlPyTs1bafoX36Wg'