Skip to main content
The event object for the custom-email-provider Actions trigger provides contextual information about email data.
NameDescriptionProperties
event.clientInformation about the client with which this login transaction was initiated.
  • client_id String. The of the application the user is logging in to.
  • metadata Dictionary. An object for holding other application properties.
  • name String. The name of the application (as defined in the Dashboard).
event.connection (Optional)Details about the connection used to authenticate the user.
  • id Optional string. The connection’s unique identifier.
  • metadata Optional dictionary. Metadata associated with the connection.
  • name Optional string. The name of the connection used to authenticate the user (such as twitter or some-g-suite-domain).
  • strategy Optional string. The type of connection. For social connections, event.connection.strategy === event.connection.name. For enterprise connections, the strategy is waad (Windows Azure AD), ad (Active Directory/LDAP), auth0 (database connections), and so on.
event.custom_domain (Optional)
  • domain Optional string. Available in MCD EA. The custom domain name.
event.notification
  • html String. Rendered HTML template.
  • from String. Email address of the sender for the email.
  • subject String.Subject to be attached to the email.
  • locale Optional string. The locale we rendered the message in, for example en_US, as defined in the BCP-47 specification.
  • message_type String. The type of message that is being sent, like verify_email or welcome_email. Possible values include:
    • verify_email
    • verify_email_by_code
    • reset_email
    • reset_email_by_code
    • welcome_email
    • verification_code
    • mfa_oob_code
    • enrollment_email
    • blocked_account
    • stolen_credentials
    • try_provider_configuration_email
    • organization_invitation
  • text String. Rendered text template.
  • to String. Email address of the recipient.
event.organization (Optional)Details about the Organization associated with the current transaction.
  • display_name String. The friendly name of the Organization.
  • id String. The Organization identifier.
  • metadata Dictionary. Metadata associated with the Organization.
  • name String. The name of the Organization.
event.request (Optional)
  • geoip Optional object. Includes the following properties:
    • countryCode Optional string.
    • countryCode3 Optional string.
    • cityName Optional string.
    • latitude Optional string.
    • longitude Optional string.
    • timeZone Optional string.
    • subdivisionCode Optional string.
    • subdivisionName Optional string.
    • continentCode Optional string.
  • hostname * Optional string*. Available in MCD EA. The hostname that is being used for the authentication flow.
  • ip Optional string. The originating IP address of the request.
  • query Optional dictionary. The query string parameters sent to the authorization request. Only supported for the Password Reset Flow.
  • user_agent Optional string. The value of the User-Agent header received when initiating the transaction.
event.tenant
  • friendly_name Optional string. The friendly name for the tenant, usually a more human-readable version of the ID.
  • home_url Optional string. The home URL for the tenant, if defined and as found in its settings.
  • id String. The name of the tenant.
  • logo_url Optional string. The logo URL for the tenant, if defined and as found in its settings.
  • support_email Optional string. The email to the tenant’s support service, if defined and as found in its settings.
  • support_url Optional string. The url to the tenant’s support service, if defined and as found in its settings.
event.userAn object describing the user on whose behalf the current transaction was initiated.
  • app_metadata Dictionary. Custom fields that store information about a user that influences the user’s access, such as support plan, security roles, or access control groups.
  • email Optional string. (unique) User’s email address.
  • email_verified Boolean. Indicates whether the user has verified their email address.
  • family_name Optional string. User’s family name.
  • given_name Optional string. User’s given name.
  • name Optional string. User’s full name.
  • nickname Optional string. User’s nickname.
  • picture Optional string. URL pointing to the user’s profile picture.
  • user_id String. (unique) User’s unique identifier.
  • user_metadata Dictionary. 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.
  • username Optional string. (unique) User’s username.
For more information on Actions, you can read: