> ## Documentation Index
> Fetch the complete documentation index at: https://docs-staging-quickstart-revamp.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

> Learn about the custom-email-provider Action trigger's event object, which provides contextual information about the message data.

# Action Triggers: custom-email-provider Event Object

The `event` object for the `custom-email-provider` Actions trigger provides contextual information about email data.

<table class="table">
  <thead>
    <tr>
      <th>Property</th>
      <th>Description</th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        <p><code>event.client</code></p>
      </td>

      <td>
        <p>
          Information about the Client with which this login transaction was
          initiated.
        </p>

        <p>Includes the following properties:</p>

        <ul>
          <li>
            <code>client\_id</code> <em>String</em>.
            <span>The <Tooltip tip="Identification value given to your registered resource from Auth0." cta="View Glossary" href="/docs/glossary?term=client+ID">client ID</Tooltip> of the application the user is logging in to.</span>
          </li>

          <li>
            <code>metadata</code> <em>Dictionary</em>.
            <span>An object for holding other application properties.</span>
          </li>

          <li>
            <code>name</code> <em>String</em>.
            <span>The name of the application (as defined in the Dashboard).</span>
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p><code>event.connection</code></p>
        <p><em>(Optional)</em></p>
      </td>

      <td>
        <p>
          Details about the Connection that was used to authenticate the user.
        </p>

        <p>Includes the following properties:</p>

        <ul>
          <li>
            <code>id</code> <em>Optional string</em>.
            <span>The connection's unique identifier.</span>
          </li>

          <li>
            <code>metadata</code> <em>Optional dictionary</em>.
            <span>Metadata associated with the connection.</span>
          </li>

          <li>
            <code>name</code> <em>Optional string</em>.
            <span>The name of the connection used to authenticate the user (such as
            <code>twitter</code> or <code>some-g-suite-domain</code>).</span>
          </li>

          <li>
            <code>strategy</code> <em>Optional string</em>.
            <span>The type of connection. For social connections,
            <code>event.connection.strategy === event.connection.name</code>.
            For enterprise connections, the strategy is
            <code>waad</code> (Windows Azure AD), <code>ad</code> (Active
            Directory/LDAP), <code>auth0</code> (database connections), and so
            on.</span>
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p><code>event.custom\_domain</code></p>
        <p><em>(Optional)</em></p>
      </td>

      <td>
        <p>Includes the following properties:</p>

        <ul>
          <li>
            <code>domain</code> <em>Optional string</em>.
            <span>Available in MCD EA. The custom domain name.</span>
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p><code>event.notification</code></p>
      </td>

      <td>
        <p>Includes the following properties:</p>

        <ul>
          <li>
            <code>html</code> <em>String</em>.
            <span>Rendered HTML template.</span>
          </li>

          <li>
            <code>from</code> <em>String</em>.
            <span>Email address of the sender for the email.</span>
          </li>

          <li><code>subject</code> <em>String</em>.<span>Subject to be attached to the email.</span></li>

          <li>
            <code>locale</code> <em>Optional string</em>.
            <span>The locale we rendered the message in, for example
            <code>en\_US</code>, as defined in the BCP-47 specification.</span>
          </li>

          <li>
            <code>message\_type</code> <em>String</em>.

            <p>
              The type of message that is being send, like
              <code>verify\_email</code> or <code>welcome\_email</code>.
            </p>

            <p>Possible values include:</p>

            <ul>
              <li><code>verify\_email</code></li>
              <li><code>verify\_email\_by\_code</code></li>
              <li><code>reset\_email</code></li>
              <li><code>reset\_email\_by\_code</code></li>
              <li><code>welcome\_email</code></li>
              <li><code>verification\_code</code></li>
              <li><code>mfa\_oob\_code</code></li>
              <li><code>enrollment\_email</code></li>
              <li><code>blocked\_account</code></li>
              <li><code>stolen\_credentials</code></li>
              <li><code>try\_provider\_configuration\_email</code></li>
              <li><code>organization\_invitation</code></li>
            </ul>
          </li>

          <li>
            <code>text</code> <em>String</em>.
            <span>Rendered text template.</span>
          </li>

          <li>
            <code>to</code> <em>String</em>.
            <span>Email address of the recipient.</span>
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p><code>event.organization</code></p>
        <p><em>(Optional)</em></p>
      </td>

      <td>
        <p>
          Details about the Organization associated with the current
          transaction.
        </p>

        <p>Includes the following properties:</p>

        <ul>
          <li>
            <code>display\_name</code> <em>String</em>.
            <span>The friendly name of the Organization.</span>
          </li>

          <li>
            <code>id</code> <em>String</em>.
            <span>The Organization identifier.</span>
          </li>

          <li>
            <code>metadata</code> <em>Dictionary</em>.
            <span>Metadata associated with the Organization.</span>
          </li>

          <li>
            <code>name</code> <em>String</em>.
            <span>The name of the Organization.</span>
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p><code>event.request</code></p>
        <p><em>(Optional)</em></p>
      </td>

      <td>
        <p>Includes the following properties:</p>

        <ul>
          <li>
            <code>geoip</code> <em>Optional object</em>.
            <p>Includes the following properties:</p>

            <ul>
              <li><code>countryCode</code> <em>Optional string</em>.</li>
              <li><code>countryCode3</code> <em>Optional string</em>.</li>
              <li><code>cityName</code> <em>Optional string</em>.</li>
              <li><code>latitude</code> <em>Optional string</em>.</li>
              <li><code>longitude</code> <em>Optional string</em>.</li>
              <li><code>timeZone</code> <em>Optional string</em>.</li>
              <li><code>subdivisionCode</code> <em>Optional string</em>.</li>
              <li><code>subdivisionName</code> <em>Optional string</em>.</li>
              <li><code>continentCode</code> <em>Optional string</em>.</li>
            </ul>
          </li>

          <li>
            <code>hostname</code> <em> Optional string</em>.
            <span>Available in MCD EA. The hostname that is being used for the authentication flow.</span>
          </li>

          <li>
            <code>ip</code> <em>Optional string</em>.
            <span>The originating IP address of the request.</span>
          </li>

          <li>
            <code>query</code> <em>Optional dictionary</em>.
            <span>The query string parameters sent to the authorization request. Only supported for the Password Reset Flow.</span>
          </li>

          <li>
            <code>user\_agent</code> <em>Optional string</em>.
            <span>The value of the <code>User-Agent</code> header received when
            initiating the transaction.</span>
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p><code>event.tenant</code></p>
      </td>

      <td>
        <p>Includes the following properties:</p>

        <ul>
          <li>
            <code>friendly\_name</code> <em>Optional string</em>.
            <span>The friendly name for the tenant, usually a more human-readable
            version of the ID.</span>
          </li>

          <li>
            <code>home\_url</code> <em>Optional string</em>.
            <span>The home URL for the tenant, if defined and as found in its
            settings.</span>
          </li>

          <li>
            <code>id</code> <em>String</em>.
            <span>The name of the tenant.</span>
          </li>

          <li>
            <code>logo\_url</code> <em>Optional string</em>.
            <span>The logo URL for the tenant, if defined and as found in its
            settings.</span>
          </li>

          <li>
            <code>support\_email</code> <em>Optional string</em>.
            <span>The email to the tenant's support service, if defined and as
            found in its settings.</span>
          </li>

          <li>
            <code>support\_url</code> <em>Optional string</em>.
            <span>The url to the tenant's support service, if defined and as found
            in its settings.</span>
          </li>
        </ul>
      </td>
    </tr>

    <tr>
      <td>
        <p><code>event.user</code></p>
      </td>

      <td>
        <p>
          An object describing the user on whose behalf the current transaction
          was initiated.
        </p>

        <p>Includes the following properties:</p>

        <ul>
          <li>
            <code>app\_metadata</code> <em>Dictionary</em>.
            <span>Custom fields that store information about a user that influences the
            user's access, such as support plan, security roles, or access
            control groups.</span>
          </li>

          <li>
            <code>email</code> <em>Optional string</em>.
            <span>(unique) User's email address.</span>
          </li>

          <li>
            <code>email\_verified</code> <em>Boolean</em>.
            <span>Indicates whether the user has verified their email
            address.</span>
          </li>

          <li>
            <code>family\_name</code> <em>Optional string</em>.
            <span>User's family name.</span>
          </li>

          <li>
            <code>given\_name</code> <em>Optional string</em>.
            <span>User's given name.</span>
          </li>

          <li>
            <code>name</code> <em>Optional string</em>.
            <span>User's full name.</span>
          </li>

          <li>
            <code>nickname</code> <em>Optional string</em>.
            <span>User's nickname.</span>
          </li>

          <li>
            <code>picture</code> <em>Optional string</em>.
            <span>URL pointing to the
            <a href="/docs/manage-users/user-accounts/change-user-picture">user's profile picture</a>.</span>
          </li>

          <li>
            <code>user\_id</code> <em>String</em>.
            <span>(unique) User's unique identifier.</span>
          </li>

          <li>
            <code>user\_metadata</code> <em>Dictionary</em>.
            <span>Custom fields that store information about a user that does not impact
            what they can or cannot access, such as work address, home
            address, or user preferences.</span>
          </li>

          <li>
            <code>username</code> <em>Optional string</em>.
            <span>(unique) User's username.</span>
          </li>
        </ul>
      </td>
    </tr>
  </tbody>
</table>

## Learn more

* [Configure a Custom Email Provider](/docs/customize/email/configure-a-custom-email-provider)
* [Write Your First Action](/docs/customize/actions/write-your-first-action)
* [Understand How Auth0 Actions Work](/docs/customize/actions/actions-overview)
* [Action Coding Guidelines](/docs/customize/actions/action-coding-guidelines)
* [Actions Limitations](/docs/customize/actions/limitations)