Generate an admin access token
Use your client credentials to generate a short-lived admin access token for authenticating with WLL’s admin API.
Some WLL API endpoints require elevated privileges and must be accessed using an admin access token. These endpoints are clearly labeled in our API reference with a red banner, listing the authorization scopes needed to access them.

These tokens are short-lived and are generated using the OAuth2 client credentials grant.
This article shows you how to generate an admin token using your client ID and secret.
Prerequisites
Before generating a token, you must have:
A valid client ID and client secret
Access to the correct audience (e.g. staging or production)
If you don’t have credentials yet, see Request API credentials.
Generating your admin access token
Request an admin access token using your client credentials via the OAuth2 token endpoint.
Pass the returned token as a Bearer token in the Authorization header of your requests to the WLL API.
This is the standard client credentials grant flow, suitable for server-side scripts, integrations, and admin automation.
Token Endpoint
The correct endpoint to request a token from depends on which region your tenant exists in.
Default (EU) endpoint:
https://auth.wlloyalty.net/oauth/tokenUS endpoint:
https://auth.us.wlloyalty.net/oauth/tokenGCC endpoint:
https://auth.me.wlloyalty.net/oauth/token
Request format
Send a JSON payload containing your client credentials and the target environment.
In the following examples, replace $YOUR_SECRET and $YOUR_ID with your client secret and client ID, respectively. The audience parameter in the request body specifies which environment the token should access.
Request a token valid for any environment
Legacy client configuration
The staging.wlloyalty.net and production.wlloyalty.net audiences only apply to clients onboarded before 10 August 2026.
Clients onboarded on or after this date should request a token valid for any environment.
Request a staging-only token (legacy clients)
These requests are identical except for the audience parameter in which we specify staging.wlloyalty.net.
Request a production-only token (legacy clients)
These requests are identical except for the audience parameter in which we specify production.wlloyalty.net.
Token lifetime
Admin tokens are valid for 24 hours (86,400 seconds) from the time they’re issued.
Last updated