Configure Anonymous Sessions

To configure anonymous sessions, you can use the Auth0 Management API.

Prerequisites

To use anonymous sessions:

You must have an Auth0 account.
Register your Auth0 application. If you do not have an Auth0 application, you can get started with the Auth0 React or Next.js Quickstarts.
Register an API (resource server).

Auth0 Management API

Configure anonymous sessions in your Auth0 tenant

To set the anonymous sessions lifetime and token format, make a PATCH request to the /api/v2/tenants/settings endpoint:

{
  "sessions": {
    "anonymous": {
      "lifetime_in_minutes": 1440,
      "token_format": "jwe"
    }
  }
}  

Enable anonymous sessions in your application

To enable anonymous sessions in your Auth0 application, make a PATCH request to the /api/v2/clients/{id} endpoint:

{
  "anonymous_sessions": {
    "active": true
  }
}

Enable anonymous access in your API

To enable anonymous sessions in your API, make a PATCH request to the /api/v2/resource-servers/{id} endpoint:

{
"allow_anonymous_access": true,
"token_lifetime_for_anonymous_access_tokens": 7200
}

Create an anonymous session

Once anonymous sessions are configured in your tenant, application, and API, you can create an anonymous session by making a POST request to the /anonymous/token endpoint:

{
  "client_id": "YOUR_CLIENT_ID",
  "audience": "YOUR_AUDIENCE",
  "scope": "anon"
}

The response includes a session_token and an access_token:

{
  "session_token": "eyJhbGciOiJkaXIiLCJlbmMiOiJBMjU2R0NNIn0...",
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 86400
}

Next steps

Anonymous Sessions Use Cases Learn about anonymous sessions use cases.

Manage Users

Manage Access

Configure Anonymous Sessions

Prerequisites

Auth0 Management API

Configure anonymous sessions in your Auth0 tenant

Enable anonymous sessions in your application

Enable anonymous access in your API

Create an anonymous session

Next steps

​Prerequisites

​Auth0 Management API

​Configure anonymous sessions in your Auth0 tenant

​Enable anonymous sessions in your application

​Enable anonymous access in your API

​Create an anonymous session

​Next steps

Prerequisites

Auth0 Management API

Configure anonymous sessions in your Auth0 tenant

Enable anonymous sessions in your application

Enable anonymous access in your API

Create an anonymous session

Next steps