Learn how to use to custom-phone-provider Event Object to configure a custom phone provider.
The event object for the custom-phone-provider Actions trigger provides contextual information about the request for sending and receiving a custom phone message.
Property
Description
event.client
Information about the Client with which this login transaction was
initiated.
Includes the following properties:
client_idString.
The of the application the user is logging in to.
metadataDictionary.
An object for holding other application properties.
nameString.
The name of the application (as defined in the Dashboard).
event.connection
(Optional)
Details about the Connection that was used to authenticate the user.
Includes the following properties:
idOptional string.
The connection’s unique identifier.
metadataOptional dictionary.
Metadata associated with the connection.
nameOptional string.
The name of the connection used to authenticate the user (such as
twitter or some-g-suite-domain).
strategyOptional 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 (Early access)
Details about the custom domain name information.
Includes the following properties:
domainString. The custom domain where the authentication event occurred.
domain.metadataObject. Metadata associated with the custom domain.
event.notification
Includes the following properties:
fromString.
The E.164 compliant phone number for the sender.
localeString.
The locale we rendered the message in, for example
en_US, as defined in the BCP-47 specification.
message_typeString.
The type of message that is being sent, like
otp_verify or blocked_account.
Possible values include:
otp_verify
otp_enroll
blocked_account
change_password
password_breach
recipientString.
The E.164 compliant phone number for the recipient.
delivery_methodEnum.
The way the message should be delivered. Could be text or voice.
codeString.
The One-Time Password for some message_types (e.g. otp_verify, otp_enroll).
as_textString.
The rendered text ready to be delivered as a text message.
as_voiceString.
The rendered text ready to be delivered as a voice text message.
event.organization
(Optional)
Details about the Organization associated with the current
transaction.
Includes the following properties:
display_nameString.
The friendly name of the Organization.
idString.
The Organization identifier.
metadataDictionary.
Metadata associated with the Organization.
nameString.
The name of the Organization.
event.request
(Optional)
Details about the request that initiated the transaction.
Includes the following properties:
geoipOptional object.
Includes the following properties:
countryCodeOptional string.
countryCode3Optional string.
cityNameOptional string.
latitudeOptional string.
longitudeOptional string.
timeZoneOptional string.
subdivisionCodeOptional string.
subdivisionNameOptional string.
continentCodeOptional string.
continentCodeOptional string.
ipOptional string.
The originating IP address of the request.
hostnameOptional string.
The hostname that is being used for the authentication flow.
methodOptional string.
The HTTP method used for the request.
languageOptional string.
The language requested by the browser.
user_agentOptional string.
The value of the User-Agent header received when
initiating the transaction.
event.tenant
Includes the following properties:
friendly_nameOptional string.
The friendly name for the tenant, usually a more human-readable
version of the ID.
home_urlOptional string.
The home URL for the tenant, if defined and as found in its
settings.
idString.
The name of the tenant.
logo_urlOptional string.
The logo URL for the tenant, if defined and as found in its
settings.
support_emailOptional string.
The email to the tenant’s support service, if defined and as
found in its settings.
support_urlOptional string.
The url to the tenant’s support service, if defined and as found
in its settings.
event.user
An object describing the user on whose behalf the current transaction
was initiated.
Includes the following properties:
app_metadataDictionary.
Custom fields that store information about a user that influences the
user’s access, such as support plan, security roles, or access
control groups.
user_metadataDictionary.
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.