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

> Learn how to configure your Auth0 pre-built flow actions to make requests against the Management API or send custom notifications.

# Auth0

## Management API

### Configure your Vault connection with Management API

To configure a Vault connection for your Auth0 Actions, you will need to [create a Machine-to-Machine](/docs/get-started/auth0-overview/create-applications/machine-to-machine-apps) application and use **Tenant domain, <Tooltip tip="Client ID: Identification value given to your registered resource from Auth0." cta="View Glossary" href="/docs/glossary?term=Client+ID">Client ID</Tooltip> and <Tooltip tip="Client ID: Identification value given to your registered resource from Auth0." cta="View Glossary" href="/docs/glossary?term=Client+Secret">Client Secret</Tooltip>**:

<Frame>
  <img src="https://mintcdn.com/generaltranslationinc/6Eil8sR_4nvgRMz0/docs/images/cdy7uua7fh8z/1IPtH5hD6QTRXsySyo2Ovr/3562828624e2fd4f308b6eb3b5042f34/auth0-vault-connection.png?fit=max&auto=format&n=6Eil8sR_4nvgRMz0&q=85&s=80a0f09fc84df932b5eba7902b02a4fb" alt="" width="1404" height="851" data-path="docs/images/cdy7uua7fh8z/1IPtH5hD6QTRXsySyo2Ovr/3562828624e2fd4f308b6eb3b5042f34/auth0-vault-connection.png" />
</Frame>

<Warning>
  Remember to authorize your Machine-to-Machine application to access the Management API and select the right scopes (eg. `update:users_app_metadata`).
</Warning>

### Create user

<Warning>
  Create User doesn't support interactions using canonical domain when combined with [Multiple Custom Domains](/docs/customize/custom-domains/multiple-custom-domains.mdx) during Early Access. To learn more, read [Product Release Stages](/docs/troubleshoot/product-lifecycle/product-release-stages.mdx).
</Warning>

Create a user.

<Frame>
  <img src="https://mintcdn.com/generaltranslationinc/3E5d0TEwC25OF1Ek/docs/images/cdy7uua7fh8z/6MQIKf2IpTtI2g7d5Pwn7u/222ec746cf9c0c1003d18ba4c0aa451e/create_user.png?fit=max&auto=format&n=3E5d0TEwC25OF1Ek&q=85&s=2e01e53d037c41a2d6eaf635b8084f14" alt="" width="1392" height="1094" data-path="docs/images/cdy7uua7fh8z/6MQIKf2IpTtI2g7d5Pwn7u/222ec746cf9c0c1003d18ba4c0aa451e/create_user.png" />
</Frame>

#### Input settings

<table class="table">
  <thead>
    <tr>
      <th><b>Parameter</b></th>
      <th><b>Description</b></th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>Body</td>
      <td>The payload of Auth0 user properties to add. To learn more, read <a href="https://auth0.com/docs/api/management/v2/users/post-users">Create a user</a>  API documentation. </td>
    </tr>
  </tbody>
</table>

#### Output object

Review [Create a user](https://auth0.com/docs/api/management/v2/users/post-users#response-messages) for expected response and status code.

### Get user

Retrieve user details.

<Frame>
  <img src="https://mintcdn.com/generaltranslationinc/RMdEvk9xid_26wCJ/docs/images/cdy7uua7fh8z/3GoNZsXOvMTYRtMQNj00mm/6e92d94cee7b165479c688358a5df242/Screenshot_2024-11-18_at_16.31.49.png?fit=max&auto=format&n=RMdEvk9xid_26wCJ&q=85&s=fe6ebb63fc035130547428ba532de1a8" alt="" width="1404" height="650" data-path="docs/images/cdy7uua7fh8z/3GoNZsXOvMTYRtMQNj00mm/6e92d94cee7b165479c688358a5df242/Screenshot_2024-11-18_at_16.31.49.png" />
</Frame>

#### Input settings

<table class="table">
  <thead>
    <tr>
      <th><b>Parameter</b></th>
      <th><b>Description</b></th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>User ID</td>
      <td>ID of the user to retrieve. To learn more, read [Get a user](https://auth0.com/docs/api/management/v2/users/get-users-by-id) API documentation. </td>
    </tr>
  </tbody>
</table>

#### Output object

Review [Get a user](https://auth0.com/docs/api/management/v2/users/get-users-by-id#response-messages) for expected response and status code.

### Update user

Update a user.

<Frame>
  <img src="https://mintcdn.com/generaltranslationinc/ZBZaCyGCDGYmrL4v/docs/images/cdy7uua7fh8z/3tymSpaeod6EksWRJp1sge/1122b244d756d754fe41baac209a132b/Screenshot_2024-11-18_at_16.49.56.png?fit=max&auto=format&n=ZBZaCyGCDGYmrL4v&q=85&s=638de66bd82af89ff68cbfe786386e64" alt="" width="1404" height="1213" data-path="docs/images/cdy7uua7fh8z/3tymSpaeod6EksWRJp1sge/1122b244d756d754fe41baac209a132b/Screenshot_2024-11-18_at_16.49.56.png" />
</Frame>

#### Input settings

<table class="table">
  <thead>
    <tr>
      <th><b>Parameter</b></th>
      <th><b>Description</b></th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>User ID</td>
      <td>ID of the user to update.</td>
    </tr>

    <tr>
      <td>Body</td>
      <td>The payload of Auth0 user properties to update. To learn more, read <a href="https://auth0.com/docs/api/management/v2/users/patch-users-by-id">Update a user</a>  API documentation. </td>
    </tr>
  </tbody>
</table>

#### Output object

You can find the expected response and status codes at [Update a user](https://auth0.com/docs/api/management/v2/users/patch-users-by-id#response-messages) API documentation.

### Custom API request

Send a custom API request to Auth0 API endpoints.

<Frame>
  <img src="https://mintcdn.com/generaltranslationinc/3E5d0TEwC25OF1Ek/docs/images/cdy7uua7fh8z/66uV9iuhwfnXUdE1quLOyx/2ae3ff26335acbcd172cbb40618a5a90/Screenshot_2025-01-24_at_18.50.26.png?fit=max&auto=format&n=3E5d0TEwC25OF1Ek&q=85&s=042749847cb768035a9284f8e23ea227" alt="Dashboard > Customize > Flows > Integrations > Auth0" data-og-width="1211" width="1211" data-og-height="862" height="862" data-path="docs/images/cdy7uua7fh8z/66uV9iuhwfnXUdE1quLOyx/2ae3ff26335acbcd172cbb40618a5a90/Screenshot_2025-01-24_at_18.50.26.png" data-optimize="true" data-opv="3" srcset="https://mintcdn.com/generaltranslationinc/3E5d0TEwC25OF1Ek/docs/images/cdy7uua7fh8z/66uV9iuhwfnXUdE1quLOyx/2ae3ff26335acbcd172cbb40618a5a90/Screenshot_2025-01-24_at_18.50.26.png?w=280&fit=max&auto=format&n=3E5d0TEwC25OF1Ek&q=85&s=79a6eb1f2ede5101f043bb7c27edf1df 280w, https://mintcdn.com/generaltranslationinc/3E5d0TEwC25OF1Ek/docs/images/cdy7uua7fh8z/66uV9iuhwfnXUdE1quLOyx/2ae3ff26335acbcd172cbb40618a5a90/Screenshot_2025-01-24_at_18.50.26.png?w=560&fit=max&auto=format&n=3E5d0TEwC25OF1Ek&q=85&s=91f4860bff2edf454e820a1ba3beaef3 560w, https://mintcdn.com/generaltranslationinc/3E5d0TEwC25OF1Ek/docs/images/cdy7uua7fh8z/66uV9iuhwfnXUdE1quLOyx/2ae3ff26335acbcd172cbb40618a5a90/Screenshot_2025-01-24_at_18.50.26.png?w=840&fit=max&auto=format&n=3E5d0TEwC25OF1Ek&q=85&s=66fe1cfbb367f0f45c79a4a78d71b6b0 840w, https://mintcdn.com/generaltranslationinc/3E5d0TEwC25OF1Ek/docs/images/cdy7uua7fh8z/66uV9iuhwfnXUdE1quLOyx/2ae3ff26335acbcd172cbb40618a5a90/Screenshot_2025-01-24_at_18.50.26.png?w=1100&fit=max&auto=format&n=3E5d0TEwC25OF1Ek&q=85&s=7c32e836cdc90cfb54a9d6cad5d4b644 1100w, https://mintcdn.com/generaltranslationinc/3E5d0TEwC25OF1Ek/docs/images/cdy7uua7fh8z/66uV9iuhwfnXUdE1quLOyx/2ae3ff26335acbcd172cbb40618a5a90/Screenshot_2025-01-24_at_18.50.26.png?w=1650&fit=max&auto=format&n=3E5d0TEwC25OF1Ek&q=85&s=ff39052c242515ac9db02a4423bad670 1650w, https://mintcdn.com/generaltranslationinc/3E5d0TEwC25OF1Ek/docs/images/cdy7uua7fh8z/66uV9iuhwfnXUdE1quLOyx/2ae3ff26335acbcd172cbb40618a5a90/Screenshot_2025-01-24_at_18.50.26.png?w=2500&fit=max&auto=format&n=3E5d0TEwC25OF1Ek&q=85&s=d7e3c8bb9b7f6aed1b1b17d7ceabd6e4 2500w" />
</Frame>

#### Input settings

<table class="table">
  <thead>
    <tr>
      <th><b>Parameter</b></th>
      <th><b>Description</b></th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        Path
      </td>

      <td>
        The API endpoint absolute pathname.
        <br />( Example: <code>/api/v2/organizations</code> )
        <br /> <b>Note:</b> Some endpoints, for example: <a href="https://auth0.com/docs/api/management/v2/users/get-users-by-id"> Get a user </a>, require URI encoded parameters when not using alphanumeric characters, such as: <code>-</code>, <code>.</code>, <code>\_</code>, or <code>\~</code>, <a href="https://datatracker.ietf.org/doc/html/rfc3986#section-2.3"> characters </a>).
        <br />To do this, you can use the encodeURIComponent function:  <br />`{{ functions.encodeURIComponent(context.user.user_id) }}`
      </td>
    </tr>

    <tr>
      <td>
        Method
      </td>

      <td>
        Available HTTP methods include:

        <ul>
          <li><code>GET</code></li>
          <li><code>POST</code></li>
          <li><code>PUT</code></li>
          <li><code>PATCH</code></li>
          <li><code>DELETE</code></li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>Body</td>
      <td>The body of the request. </td>
    </tr>

    <tr>
      <td>Headers</td>
      <td>The headers of the request. </td>
    </tr>

    <tr>
      <td>URL Params</td>
      <td>The URL parameters. These parameters are automatically URL-encoded. </td>
    </tr>
  </tbody>
</table>

#### Output object

Review [Auth0 Management API](https://auth0.com/docs/api/management/v2/introduction) for expected responses and status codes.

## Notifications

### Send email

Send a custom email using your [configured email provider](https://auth0.com/docs/customize/email).

<Warning>
  [Email Provider](https://auth0.com/docs/customize/email) must be enabled before using this action.
</Warning>

<Frame>
  <img src="https://mintcdn.com/generaltranslationinc/md6b8ua1hdYa2pM7/docs/images/forms/flows/integrations/auth0-notifications-send-email.png?fit=max&auto=format&n=md6b8ua1hdYa2pM7&q=85&s=bff2992a76ea2c81427ba642bb889488" alt="" width="1222" height="828" data-path="docs/images/forms/flows/integrations/auth0-notifications-send-email.png" />
</Frame>

#### Input settings

| Parameter               | Description                                                                                                                                                                                                                |
| ----------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Use custom sender email | By default, we will use the sender email you have configured in your customized email provider settings.  Enable this option if you want to use a different sender email or name.                                          |
| Recipient email         | The recipient’s email                                                                                                                                                                                                      |
| Subject                 | The email subject                                                                                                                                                                                                          |
| Custom variable         | Add custom variables to be inserted in your email template. Once configured, you can reference them using `{{custom_vars.your_variable_key}}`.                                                                             |
| Message                 | Email message in HTML format using Liquid syntax. You can use [common variables](https://auth0.com/docs/customize/email/email-templates#common-variables) or custom ones using `{{custom_vars.your_variable_key}}` syntax. |

#### Output object

| Property | Type    | Description                                                                                                  |
| -------- | ------- | ------------------------------------------------------------------------------------------------------------ |
| success  | Boolean | Indicates if the email was successfully queued to be sent, regardless of whether the delivery failed or not. |

#### Output object example

```json theme={null}
{
  "success": true
}
```
