How to use and connect to our API

General information

The API supports QUERY PARAMETERS as select, relations, filters, limit, offset and sort. Different endpoints might have different supported parameters so check for each documentation of what is permitted.

Authenticate your account when using the API by including your secret Access Token in the request. Authentication is performed by passing the Access Token in the Authorization header.

Documentation about Simployer One's Public API

Our API documentation is available at docs.alexishr.com. 

Documentation about Simployer One's Provisioning API

Our API documentation is available at https://docs.alexishr.com/scim/. 

How to generate an Access token

To use Simployer One's API you need an Access Token. Since the API connects you to all information available about employees in Simployer One you need to be an Owner to create this (see this article about Permissions).

If you are an Owner you can generate the Access token in Settings -> Access tokens. 

You can choose if the Access token should allow for API access to the Public API and/or the Provisioning API. 

Note: The token created will only be visible once, so make sure to keep it safe! The access token will be tied to the user who created it, so if the user that created the token has its permission changed or if it's removed the token will become invalid.