Manage Users Using the Management API

In addition to using the Dashboard, you can retrieve, create, update or delete users using the Management API. If you want to call the Management API directly, you will first need to generate the appropriate access token. To learn more, read Access Tokens for the Management API. Alternatively, you can use an SDK to implement the functionality you need to call the Management API from your application. For a list of available SDKs, read the SDKs section of our Support Matrix.

To learn how to manage Auth0 Dashboard access for your team members, read Manage Dashboard Access.

Permissions

Use the following permissions to get an access token for the machine-to-machine applications. To learn more, read Register Machine-to-Machine Applications.

Permissions Descriptions
read:users Applications can search and retrieve any user records stored in an Auth0 tenant. This includes reading via the /api/v2/users , /api/v2/users-by-email, and /api/v2/jobs/users-export endpoints.
create:users Applications can create users in any database or passwordless connection in an Auth0 tenant. This includes creating via the /api/v2/users and /api/v2/jobs/users-import endpoints.

The /api/v2/users endpoint also requires the client ID to be added to the enabled_clients property of the connection, similar to the sign-up endpoint.
update:users Applications can update any user stored in an Auth0 tenant. This includes updating via the /api/v2/users endpoint.
update:users_app_metadata Applications can update only the user.app_metadata attribute for any user stored in an Auth0 tenant. This includes updating via the /api/v2/users endpoint.
delete:users Applications can delete any user stored in an Auth0 tenant. This includes deleting via the /api/v2/users endpoint.

Limitations

By default, user profile attributes provided by identity providers other than Auth0 (such as Google, Facebook, or X) are not directly editable because they are updated from the identity provider each time the user logs in.

To be able to edit the name, nickname, given_name, family_name, or picture root attributes on the normalized user profile, you must configure your connection sync with Auth0 so that user attributes will be updated from the identity provider only on user profile creation. These root attributes will then be available to be edited individually or by bulk imports

You can set passwords using the create or update endpoints, but for security purposes, passwords cannot be viewed with the get or list user commands. The right side of the API explorer provides hints on the user profile attributes which can be viewed or modified for any given call.

Endpoints

  • Use the /users endpoint to retrieve information about all users. You can also include search criteria to find specific users.

  • Use the /user_id to retrieve information about one user based on the user_id. The user_id is an internal identifier that consists of a connection name and a unique identifier for the user. The user_id is different from the ID token.

  • The /userinfo endpoint takes as input the Auth0 access token and returns user profile information. This endpoint will include the results of any rules that may have altered the user profile during the authentication transaction, but the resulting user profile will not be filtered by any Scoping.

  • The /tokeninfo endpoint takes as input the Auth0 ID token and returns user profile information. This endpoint will return a result that does not include the results of any rules that alter the user profile.

Learn more