Authentication

Authentication for our API users is based on an access key system. To find your access key, navigate to the Alocity portal and, once logged in, navigate to the settings page by clicking on the gear icon at the top of the page. Once on the settings page, click on the Integration card.

Using the endpoint on this page and a valid access key, you will be able to request a JWT token for use in other endpoints. Note that every time you generate a JWT token, the previous one will be invalidated.

For all other requests, the authorization header of those requests will need to be set to:

Authorization: Bearer Token_Here

Controlled Errors

These are the error codes that will be returned when the hasErrors property is equal to true.

Error CodeError Message
error_accesskey_not_foundInvalid Access Key provided
error_accesskey_is_inactiveAccess Key was either deactivated or has expired.
error_user_not_foundAPI user was not found for your account. Please contact support.
failed_system_operationOperation Failed
Language
Click Try It! to start a request and see the response here!