> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hightouch.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Auth0

> Sync user lists to Auth0 and automate and manage all of your passwords, grants, and permissions in a single platform

## Setup

After selecting Auth0 from our Destinations catalog, you will be prompted to enter
your *Auth0 domain*, *Client ID*, and *Client secret* from your **registered
machine-to-machine (M2M) application for Hightouch**. You should find this by navigating
to your Auth0 dashboard -> Applications dropdown -> Applications -> select corresponding
Hightouch M2M. This particular M2M will give Hightouch permission to connect with your
Management API and update your users.

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-auth0-config.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=a3d42e4438799a2230d86676c43f3e56)

### Registering your M2M for Hightouch

If you do not have a registered M2M for Hightouch, refer to
[this Auth0 doc](https://auth0.com/docs/get-started/create-apps/machine-to-machine-apps) on
how to get started. You will then need to select the following configuration:

* Select the **Auth0 Management API**

  ![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-auth0-api-selection.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=6fee5b483229a34e0d03e3c9f37050ea)
* Check the **update:users** permission.

  ![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-auth0-permissions.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=3860abe7dbe83bbc45d01f436d43fbbf)

After you authorize, you should go to the M2M's settings to obtain the required keys.

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-auth0-m2m-settings.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=5064a2d3aba87e3710575a1e2b82df1c)

> [!NOTE]
>
> Keep in mind you might have to go back and add to the permissions for
> potential future features.

## Syncing rows

Hightouch supports syncing to the following Auth0 objects:

* `Users`

User objects in Auth0 will use the external ID as its own ID. Therefore, the user's source ID
(that is, external ID) must be present to properly match the user.

### Sync modes

This integration only supports **Update** mode.
In this mode, the destination will update the mapped attributes and metadata to the user objects.
It will not add new users.

### Record matching

Records can be matched from your source to Auth0 workspace by the external user's ID only.

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-auth0-external-mapping.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=256583dc3ce32abf7a5843ca202c162b)

### Field mapping

You can sync columns from your source to Auth0's user attributes, including the app and user's metadata.
You can view this [list for the supported Auth0 user attributes](https://auth0.com/docs/users/user-profiles/user-profile-structure).
The app and user metadata holds custom data so can take any shape or form.

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-auth0-field-mappings.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=f04cace960281def645214de39a89e6d)

![](https://mintcdn.com/hightouch-3c037897/L_vQfA0JQEpeGUUo/images/destinations/destination-auth0-data-mappings.png?fit=max\&auto=format\&n=L_vQfA0JQEpeGUUo\&q=85\&s=87993ce192c6ab6af6ab859076e74cc4)

## Tips and troubleshooting

To see the exact API requests and responses from each sync run, use the [live debugger](https://docs.hightouch.com/syncs/debugger.md). To get notified by Slack, PagerDuty, SMS, or email when a sync fails, set up [sync alerts](https://docs.hightouch.com/syncs/alerting.md). If you run into an issue this page doesn't cover, [contact support](#pylon-chat).