Skip to main content

Workflow events, conditions, and actions

Events, conditions, and actions that are supported by Workflows

The following is a list of events, conditions, and actions we currently support. Since Workflows have broad potential application, we will continue to expand the list of supported events, conditions, and actions based on your feedback. Please note that we're adding new conditions to our Workflows frequently, so it's possible this isn't an exhaustive list of the conditions that Workflows offer. Please reach out to us at support@withpersona.com if you'd like to request a new condition be added to Workflows — we'd be happy to work with you!

Supported events

These event types include inquiry events, report events, and case events (learn more about Cases).

  • inquiry.completed
  • inquiry.expired
  • inquiry.failed
  • report/adverse-media.matched
  • report/adverse-media.ready
  • report/comply-advantage-search.ready
  • report/email-address.ready
  • report/phone-number.ready
  • report/profile.ready
  • report/sec-action-lookup.ready
  • report/social-media.ready
  • report/synthetic.ready
  • report/watchlist.matched
  • report/watchlist.ready
  • case.resolved
  • case.created

Supported actions

These are a list of actions that you can take on the inquiry associated with the relevant event. 

  • Add tag (on inquiry)
  • Add tag on account
  • Decline (inquiry)
  • Approve (inquiry)
  • Do nothing (to inquiry status)
  • Mark (inquiry) for review
  • Remove tag (on inquiry)
  • Remove tag on account
  • Create and resolve case
  • Create case

Supported criteria

This list may not be exhaustive, as we're constantly adding new criteria to our Workflows. These criteria are related to the inquiry, inquiries associated with the account, and reports that are run.

  • Country - the country of residence of the individual, as determined by the information provided during the inquiry.
  • Selected country - the country of residence of the individual, as reported by the individual.
  • Country from device - the country the individual's device is located in.
  • Country comparison - whether the device is in the user's country of residence, as determined by the information provided during the inquiry.
  • US state description - the state of residence of an individual in the US, as determined by the information provided during the inquiry.
  • Selfie similarity score - score representing similarity between the submitted selfie and the face on the ID.
  • Selfie liveness score - score representing confidence in the liveness of the submitted selfie.
  • Government ID confidence score - score representing confidence in the validity of the submitted ID.
  • Liveness confidence score - same as selfie liveness score.
  • Number of failed verification attempts - within the inquiry, the number of failed verification attempts.
  • Filled properties - properties that were filled on this inquiry. Eg. name_first, name_last, etc
  • List matches - lists the individual has matched against.
  • Age - age of the individual.
  • Completed at - completion time of the inquiry.
  • Created at - creation time of the inquiry.
  • Template - the template that the inquiry is from.
  • Government ID expired - whether or not an expired ID was submitted.
  • Government ID type - the type of government ID submitted (e.g. driver's license) as collected from information provided during the inquiry.
  • Inquiry has documents - whether or not the inquiry has supplementary documents submitted.
  • Inquiry has started - whether or not the inquiry has been started.
  • Account property matches - account properties the inquiry has matched against.
  • Account tags - tags on the related account.
  • Failed verification checks - checks the inquiry has failed.
  • Government ID tags - tagged properties on government ID.
  • Account name matches - checks if the names on an account are found among the names collected from the inquiry.
  • Capture method - matches on the capture methods used by the individual during the inquiry.
  • Social security number digit count - the number of digits in the Social Security number collected from the inquiry.
  • Threat level - threat rating of the individual's device.
  • Proxy detected - whether the individual used a proxy while completing the inquiry.
  • Tor detected - whether the individual used Tor while completing the inquiry.
  • Last two verifications geolocation delta - distance in meters between the locations of the last two verifications during the inquiry.
  • Geolocation to residency delta - distance in meters from the individual's residence to the device's location.
  • Device count- number of unique devices associated with the inquiry.
  • Session count - number of unique sessions associated with the inquiry.
  • Browser count - number of unique browsers associated with the inquiry.
  • IP address count - number of unique IP addresses associated with the inquiry.
  • Inquiry field value - value of a field on the inquiry.
  • Random sample - randomly selects a percentage of items.
  • Passed database verification count - number of passed database verifications on the inquiry.
  • Failed database verification count - number of failed database verifications on the inquiry.
  • Abuse score - the score of an account with synthetic or other first party fraud.
  • First party synthetic score - the score of an account with a true name and DOB but a fictitious SSN.
  • Third party synthetic score - the score of an account that consists of a name, DOB, and SSN that describe a fictitious person.
  • Match found - whether or not there was a match on a watchlist.
  • Phone type - inferred type of phone according to phone records.
  • Phone carrier - inferred phone carrier according to phone records.
  • Phone number risk score - risk score of phone number based on properties of device and of use.
  • Phone number risk recommendation - risk recommendation of phone number based on properties of device and of use.
  • Countries - countries recorded on the adverse media report report.
  • Adverse media types - adverse media types on this report.
  • Adverse media relevance types - relevance types on this report.
  • Email address reputation - reputation of an email address associated with email risk report.
  • Email address domain reputation - reputation of an email address domain associated with email risk report.
  • Email address first seen - the number of days since the email address was first seen according to the email risk report.
  • Email address last seen - the number of days since the email address was last seen according to the email risk report.
  • Email address domain created - the number of days since the email domain was created according to the email risk report.
  • Email address reference count - the number of references the email address has according to the email risk report.
  • Email address domain exists - whether or not the email address domain exists according to the email risk report.
  • Email address blacklisted - whether or not the email address is blacklisted according to the email risk report.
  • Email address deliverable - whether or not the email address is deliverable according to the email risk report.
  • Email address disposable - whether or not the email address is disposable according to the email risk report.
  • Email address free provider - whether or not the email address is a free provider according to the email risk report.
  • Email address spam - whether or not the email address is spam according to the email risk report.
  • Email address suspicious - whether or not the email address is suspicious according to the email risk report.
  • Email address valid mx- whether or not the email address has a valid MX record according to the email risk report.
  • Email address domain - the email address domain according to the email risk report.
  • Related inquiry account property matches - account properties the related inquiry has matched against.
  • Related inquiry age - age recorded on the related inquiry.
  • Related inquiry browser count - number of unique browsers associated with the related inquiry.
  • Related inquiry capture method - matches on the capture methods used by the individual during the related inquiry.
  • Related inquiry country - country recorded on the inquiry.
  • Related inquiry country comparison - whether the device is in the user's country of residence, as determined by the information provided during the related inquiry.
  • Related inquiry country from device - the country the individual's device is located in.
  • Related inquiry document similarity score - score representing similarity between the submitted selfie and the face on the ID on the related inquiry.
  • Related inquiry failed verification checks - checks the related inquiry has failed.
  • Related inquiry failed verification attempts - number of failed verification attempts on the related inquiry.
  • Related inquiry field value - value of a field on the related inquiry.
  • Related inquiry filled properties - properties that were filled on the related inquiry. Eg. name_first, name_last, etc
  • Related inquiry's geolocation to residency delta - distance in meters from the individual's residence to the device's location as determined in the related inquiry.
  • Related inquiry government ID expired - whether or not an expired ID was submitted on the related inquiry.
  • Related inquiry government ID tags - tagged properties on the related inquiry's government ID.
  • Related inquiry ID classes - the type of government ID submitted, for example, driver license, as collected from information provided during the inquiry.
  • Related inquiry IP address count - number of unique IP addresses associated with the related inquiry.
  • Related inquiry last two verifications geolocation delta - distance in meters between the locations of the last two verifications during the related inquiry.
  • Related inquiry list matches - list matches on the related inquiry.
  • Related inquiry proxy detected - whether the individual used a proxy while completing the related inquiry.
  • Related inquiry selected country - the country of residence of the individual, as reported by the individual, on the inquiry related to this report.
  • Related inquiry device count - number of unique devices associated with the related inquiry.
  • Related inquiry session count - number of unique sessions associated with the related inquiry.
  • Related inquiry social security number digit count - the number of digits in the Social Security number collected from the related inquiry.
  • Related inquiry status - status of the inquiry related to this report.
  • Related inquiry template - the template that the related inquiry is from.
  • Related inquiry threat level - threat rating of the individual's device.
  • Related inquiry Tor detected - whether the individual used Tor while completing the related inquiry.
  • Related inquiry US state - US state recorded on the inquiry related to this report.
  • Related account tags - tags associated with the related account.
  • Case template - case template associated with this case.
  • Case resolution - resolution of this case.
Last updated: