Documentation for externally authenticating to Loupe
Obtaining an Access Token
Loupe uses OAuth2/OpenID Connect to authenticate users. Below is how to obtain an access token for external integrations.
POST - https://id.atelier.technology/connect/token
Parameters
grant_type
(string, required): Use "password" for this authentication method.resource
(string, required): Use "api://enterprise" to access the production environment of Loupe.username
(string, required): Use the email address of the user account you want to authenticate.password
(string, required): Use the password of the user account you want to authenticate.
Obtaining a Refresh Token
To obtain a refresh token include the scope
parameter in your call. All other parameters should be the same as when obtaining an access token.
POST - https://id.atelier.technology/connect/token
Parameters
grant_type
(string, required): Enter "password" for this authentication method.resource
(string, required): Enter "api://enterprise" to access the production environment of Loupe.username
(string, required): Enter the email address of the user account you want to authenticate.password
(string, required): Enter the password of the user account you want to authenticate.scope
(string, required): Enter "offline_access" to obtain a refresh token.
Obtaining an Access Token Using a Refresh Token
Perform the following query to obtain an access token using a refresh token.
POST - https://id.atelier.technology/connect/token
Parameters
grant_type
(string, required): Enter "refresh_token" for this authentication method.resource
(string, required): Enter "api://enterprise" to access the production environment of Loupe.refresh_token
(string, required): Enter the refresh token you previously obtained.
Note: Loupe uses bearer tokens, so be sure to include "bearer" when authenticating. For example, authorization = "bearer <access_token>"