Events

Events are actions in the Persona system that you can use to trigger Webhooks and Workflows.

You can view events and their payloads in the Dashboard under Integration > Events. Events up to 3 months old can be viewed.

Types of Events

The following is a list of all the events that currently may be emitted by the Persona service, grouped by resource.

This list can grow at any time so when developing against Persona events, please do not assume within your code that this is the full exhaustive list.

Account events

account.created
Occurs whenever an account is created.

account.redacted
Occurs whenever an account is redacted.

account.archived
Occurs whenever an account is archived.

account.restored
Occurs whenever an account is un-archived.

account.consolidated
Occurs when the account was combined with another account.

account.consolidated-with
Occurs when another account was combined into this account.

account.status-updated
Occurs when an account’s status is updated.

account.tag-added
Occurs when a tag was added to an account.

account.tag-removed
Occurs when a tag was removed from an account.

account.updated-fields
Occurs when one or more of an account’s fields are updated.

account.updated-tags
Occurs when an account’s tags are updated.

account.added-relation
Occurs when a relation is added to an account.

account.removed-relation
Occurs when a relation is removed from an account.

Account type events

account-type.deleted-field
Occurs when a field is deleted from an account type.

Agent conversation events

agent-conversation.created
Occurs when an agent conversation is created.

agent-conversation.message-added
Occurs when a message is added to an agent conversation.

agent-conversation.errored
Occurs when an agent conversation errors.

Authentication events

authentication.created
Occurs when an authentication is created.

authentication.completed
Occurs when an authentication is completed.

authentication.expired
Occurs when an authentication expires.

authentication.failed
Occurs when an authentication fails.

authentication.redacted
Occurs when an authentication is redacted.

Case events

case.created
Occurs when a case is created.

case.assigned
Occurs when a case is assigned.

case.resolved
Occurs when a case is resolved.

case.reopened
Occurs when a case is reopened.

case.updated
Occurs when a case is updated.

case.updated-fields
Occurs when one or more of a case’s fields are updated.

case.updated-tags
Occurs when a case’s tags are updated.

case.status-updated
Occurs when a case’s status is updated.

case.queue-updated
Occurs when a case’s queue is updated.

case.sla-expired
Occurs when a case’s SLA expires.

case.exported
Occurs when a case is exported.

case.redacted
Occurs when a case is redacted.

case.agent-reviewed
Occurs when a case is reviewed by an agent.

case.print-initiated
Occurs when printing is initiated for a case.

Case comment events

case-comment.created
Occurs when a comment is created on a case.

Case message events

case-message.sent
Occurs when a case message is sent.

case-message.received
Occurs when a case message is received.

Case template events

case-template.deleted-field
Occurs when a field is deleted from a case template.

Checkpoint events

checkpoint.created
Occurs when a checkpoint is created.

checkpoint.started
Occurs when a checkpoint is started.

checkpoint.expired
Occurs when a checkpoint expires.

checkpoint.completed
Occurs when a checkpoint completes.

checkpoint.failed
Occurs when a checkpoint fails.

checkpoint.reusable-persona-used
Occurs when a reusable persona is used on a checkpoint.

Connect / Share Token events

connect/share-token.outbound-created
Occurs in the Source Organization when it creates a Share Token for a Destination Organization.

connect/share-token.outbound-redeemed
Occurs in the Source Organization when the Destination Organization’s Share Token redemption has finished.

connect/share-token.inbound-created
Occurs in the Destination Organization when a Source Organization creates a Share Token for it.

connect/share-token.inbound-redeemed
Occurs in the Destination Organization when its Share Token redemption has finished.

connect/share-token.ready
Occurs when a Share Token is ready.

Document events

document.created
Occurs whenever a document is created.

document.submitted
Occurs whenever a document is submitted.

document.extracted
Occurs whenever data is extracted from a document.

document.pending
Occurs whenever a document is pending processing.

document.processed
Occurs whenever a document is processed.

document.errored
Occurs whenever a document errors while processing.

Filing events

filing.created
Occurs when a filing is created.

filing.filed
Occurs when a filing is filed.

Graph query events

graph-query.submitted
Occurs when a graph query is submitted.

graph-query.completed
Occurs when a graph query completes.

graph-query.errored
Occurs when a graph query errors.

graph-query.cancelled
Occurs when a graph query is cancelled.

graph-query.timed-out
Occurs when a graph query times out.

graph-query.reran
Occurs when a graph query is rerun.

Importer pipeline run events

importer-pipeline-run.started
Occurs when an importer pipeline run starts.

importer-pipeline-run.completed
Occurs when an importer pipeline run completes.

importer-pipeline-run.errored
Occurs when an importer pipeline run errors.

importer-pipeline-run.canceled
Occurs when an importer pipeline run is canceled.

importer-pipeline-run.paused
Occurs when an importer pipeline run is paused.

importer-pipeline-run.resumed
Occurs when an importer pipeline run is resumed.

Inquiry events

inquiry.created
Occurs whenever an inquiry is created.

inquiry.started
Occurs whenever an inquiry is started. This happens the moment a verification is created or submitted on an inquiry.

inquiry.expired
Occurs when an inquiry expires. The default expiry is 24 hours.

inquiry.transitioned
Occurs whenever a dynamic flow inquiry moves from one step in the inquiry flow to the next.

inquiry.completed
Occurs whenever an inquiry completes all the configured verifications.

inquiry.failed
Occurs whenever an inquiry exceeds the configured number of verifications.

inquiry.marked-for-review
Occurs when an inquiry was marked for review either through Workflows or the API.

inquiry.approved
Occurs whenever an inquiry is approved manually in the dashboard or automatically through Workflows or the API.

inquiry.declined
Occurs when an inquiry is declined manually in the dashboard or automatically through Workflows or the API.

inquiry.redacted
Occurs when an inquiry is redacted.

inquiry.updated-tags
Occurs when an inquiry’s tags are updated.

inquiry.reusable-persona-created
Occurs when a reusable persona is created from an inquiry.

inquiry.reusable-persona-updated
Occurs when a reusable persona is updated with data from an inquiry.

inquiry.reusable-persona-used
Occurs when a reusable persona is used on an inquiry.

inquiry.reusable-persona-assurance-failed
Occurs when a reusable persona was used on an inquiry but data was not shared due to an insufficient assurance level.

Inquiry session events

inquiry-session.started
Occurs whenever a user starts a session on an inquiry with a device. Multiple devices will each spawn a session.

inquiry-session.expired
Occurs when a session expires.

inquiry-session.canceled
Occurs when a session is manually canceled by the user. Because sessions may be resumed, there may be multiple cancel events for a given session.

Inquiry template version events

inquiry-template-version.created
Occurs when an inquiry template version is created.

inquiry-template-version.published
Occurs when an inquiry template version is published.

Integration log events

integration-log.created
Occurs when an external integration log is created. This is emitted after both the request and the response have been received.

Report events

report/address-lookup.ready
Occurs when an address lookup report has completed processing.

report/address-lookup.submitted
Occurs when an address lookup report is submitted for processing.

report/address-lookup.errored
Occurs when an address lookup report’s processing has errored.

report/adverse-media.matched
Occurs when an adverse media report has matched against at least one adverse media source as specified within the configuration.

report/adverse-media.dismissed
Occurs when a match on an adverse media report is dismissed.

report/adverse-media.ready
Occurs when an adverse media report has completed processing.

report/adverse-media.errored
Occurs when an adverse media report’s processing has errored.

report/better-business-bureau.ready
Occurs when a Better Business Bureau report has completed processing.

report/better-business-bureau.errored
Occurs when a Better Business Bureau report’s processing has errored.

report/business-adverse-media.matched
Occurs when a business adverse media report has matched against at least one adverse media source as specified within configuration.

report/business-adverse-media.dismissed
Occurs when a match on a business adverse media report is dismissed.

report/business-adverse-media.ready
Occurs when a business adverse media report has completed processing.

report/business-adverse-media.errored
Occurs when a business adverse media report’s processing has errored.

report/business-associated-persons.ready
Occurs when a business associated persons report has completed processing.

report/business-associated-persons.errored
Occurs when a business associated persons report’s processing has errored.

report/business-classification.ready
Occurs when a business classification report has completed processing.

report/business-classification.submitted
Occurs when a business classification report is submitted for processing.

report/business-classification.errored
Occurs when a business classification report’s processing has errored.

report/business-enforcement-action.ready
Occurs when a business enforcement action report has completed processing.

report/business-enforcement-action.submitted
Occurs when a business enforcement action report is submitted for processing.

report/business-enforcement-action.errored
Occurs when a business enforcement action report’s processing has errored.

report/business-industry-classification.ready
Occurs when a business industry classification report has completed processing.

report/business-industry-classification.submitted
Occurs when a business industry classification report is submitted for processing.

report/business-industry-classification.errored
Occurs when a business industry classification report’s processing has errored.

report/business-legal-history.ready
Occurs when a business legal history report has completed processing.

report/business-legal-history.errored
Occurs when a business legal history report’s processing has errored.

report/business-liens-lookup.ready
Occurs when a business liens lookup report has completed processing.

report/business-liens-lookup.errored
Occurs when a business liens lookup report’s processing has errored.

report/business-lookup.ready
Occurs when a business lookup report has completed processing.

report/business-lookup.errored
Occurs when a business lookup report’s processing has errored.

report/business-media-coverage.matched
Occurs when a business media coverage report returns a match.

report/business-media-coverage.ready
Occurs when a business media coverage report has completed processing.

report/business-media-coverage.submitted
Occurs when a business media coverage report is submitted for processing.

report/business-media-coverage.errored
Occurs when a business media coverage report’s processing has errored.

report/business-nonprofit.changed
Occurs when a business nonprofit report’s results change.

report/business-nonprofit.ready
Occurs when a business nonprofit report has completed processing.

report/business-nonprofit.errored
Occurs when a business nonprofit report’s processing has errored.

report/business-online-presence.ready
Occurs when a business online presence report has completed processing.

report/business-online-presence.submitted
Occurs when a business online presence report is submitted for processing.

report/business-online-presence.errored
Occurs when a business online presence report’s processing has errored.

report/business-personnel-insights.ready
Occurs when a business personnel insights report has completed processing.

report/business-personnel-insights.submitted
Occurs when a business personnel insights report is submitted for processing.

report/business-personnel-insights.errored
Occurs when a business personnel insights report’s processing has errored.

report/business-registrations-lookup.ready
Occurs when a business registrations lookup report has completed processing.

report/business-registrations-lookup.errored
Occurs when a business registrations lookup report’s processing has errored.

report/business-social-media.ready
Occurs when a business social media report has completed processing.

report/business-social-media.errored
Occurs when a business social media report’s processing has errored.

report/business-watchlist.ready
Occurs when a business watchlist report has completed processing.

report/business-watchlist.matched
Occurs when a business watchlist report has matched against a watchlist as specified within the configuration.

report/business-watchlist.dismissed
Occurs when a match on a business watchlist report is dismissed.

report/business-watchlist.errored
Occurs when a business watchlist report’s processing has errored.

report/business-website.ready
Occurs when a business website report has completed processing.

report/business-website.errored
Occurs when a business website report’s processing has errored.

report/community-safety.matched
Occurs when a community safety report returns a match.

report/community-safety.ready
Occurs when a community safety report has completed processing.

report/community-safety.errored
Occurs when a community safety report’s processing has errored.

report/crypto-address-watchlist.matched
Occurs when a crypto address watchlist report returns a match.

report/crypto-address-watchlist.ready
Occurs when a crypto address watchlist report has completed processing.

report/crypto-address-watchlist.errored
Occurs when a crypto address watchlist report’s processing has errored.

report/custom-list.matched
Occurs when a custom list report returns a match.

report/custom-list.dismissed
Occurs when a match on a custom list report is dismissed.

report/custom-list.ready
Occurs when a custom list report has completed processing.

report/custom-list.errored
Occurs when a custom list report’s processing has errored.

report/email-address.ready
Occurs when an email address report has completed processing.

report/email-address.errored
Occurs when an email address report’s processing has errored.

report/finra-broker-check.ready
Occurs when a FINRA broker check report has completed processing.

report/finra-broker-check.errored
Occurs when a FINRA broker check report’s processing has errored.

report/nces.ready
Occurs when an NCES report has completed processing.

report/nces.errored
Occurs when an NCES report’s processing has errored.

report/phone-number.ready
Occurs when a phone number report is ready.

report/phone-number.errored
Occurs when a phone number report’s processing has errored.

report/politically-exposed-person.matched
Occurs when a politically exposed person (PEP) report has matched against a watchlist as specified within the configuration.

report/politically-exposed-person.dismissed
Occurs when a match on a politically exposed person (PEP) report is dismissed.

report/politically-exposed-person.ready
Occurs when a politically exposed person (PEP) report has completed processing.

report/politically-exposed-person.errored
Occurs when a politically exposed person (PEP) report’s processing has errored.

report/profile.ready
Occurs when a profile report is ready.

report/profile.errored
Occurs when a profile report’s processing has errored.

report/profile-non-authoritative.ready
Occurs when a non-authoritative profile report has completed processing.

report/profile-non-authoritative.errored
Occurs when a non-authoritative profile report’s processing has errored.

report/screening.matched
Occurs when a screening report returns a match.

report/screening.reviewed
Occurs when a screening report is reviewed.

report/screening.ready
Occurs when a screening report has completed processing.

report/screening.errored
Occurs when a screening report’s processing has errored.

report/sec-action-lookup.ready
Occurs when a SEC action lookup report has completed processing.

report/sec-action-lookup.errored
Occurs when a SEC action lookup report’s processing has errored.

report/social-media.ready
Occurs when a social media report has completed processing.

report/social-media.errored
Occurs when a social media report’s processing has errored.

report/synthetic.ready
Occurs when a synthetic report has completed processing.

report/synthetic.errored
Occurs when a synthetic report’s processing has errored.

report/watchlist.matched
Occurs when a watchlist report has matched against a watchlist as specified within the configuration.

report/watchlist.dismissed
Occurs when a match on a watchlist report is dismissed.

report/watchlist.ready
Occurs when a watchlist report has completed processing.

report/watchlist.errored
Occurs when a watchlist report’s processing has errored.

report/chainalysis-address-screening.ready
Occurs when a Chainalysis address screening report has completed processing.

report/chainalysis-address-screening.errored
Occurs when a Chainalysis address screening report’s processing has errored.

report/coinbase-check-crypto-risk.ready
Occurs when a Coinbase check crypto risk report has completed processing.

report/coinbase-check-crypto-risk.errored
Occurs when a Coinbase check crypto risk report’s processing has errored.

report/kyckr-business-lookup.ready
Occurs when a Kyckr business lookup report has completed processing.

report/kyckr-business-lookup.errored
Occurs when a Kyckr business lookup report’s processing has errored.

report/middesk.submitted
Occurs when a Middesk report is submitted for processing.

report/middesk.ready
Occurs when a Middesk report has completed processing.

report/middesk.errored
Occurs when a Middesk report’s processing has errored.

report/mx-account.ready
Occurs when an MX account report has completed processing.

report/mx-account.errored
Occurs when an MX account report’s processing has errored.

report/novacredit-cash-atlas.submitted
Occurs when a NovaCredit Cash Atlas report is submitted for processing.

report/novacredit-cash-atlas.ready
Occurs when a NovaCredit Cash Atlas report has completed processing.

report/novacredit-cash-atlas.errored
Occurs when a NovaCredit Cash Atlas report’s processing has errored.

report/novacredit-credit-passport.submitted
Occurs when a NovaCredit Credit Passport report is submitted for processing.

report/novacredit-credit-passport.ready
Occurs when a NovaCredit Credit Passport report has completed processing.

report/novacredit-credit-passport.errored
Occurs when a NovaCredit Credit Passport report’s processing has errored.

report/trm-wallet-screening.ready
Occurs when a TRM wallet screening report has completed processing.

report/trm-wallet-screening.errored
Occurs when a TRM wallet screening report’s processing has errored.

report/sentilink-application-risk.ready
Occurs when a SentiLink application risk report has completed processing.

report/sentilink-application-risk.errored
Occurs when a SentiLink application risk report’s processing has errored.

report/sentilink-scores.ready
Occurs when a SentiLink scores report has completed processing.

report/sentilink-scores.errored
Occurs when a SentiLink scores report’s processing has errored.

report/clearbit-business-lookup.ready
Occurs when a Clearbit business lookup report has completed processing.

report/clearbit-business-lookup.errored
Occurs when a Clearbit business lookup report’s processing has errored.

report/equifax-oneview.ready
Occurs when an Equifax OneView report has completed processing.

report/equifax-oneview.errored
Occurs when an Equifax OneView report’s processing has errored.

SAR events

sar.created
Occurs when a Suspicious Activity Report (SAR) is created.

sar.filed
Occurs when a Suspicious Activity Report (SAR) is filed.

Selfie events

selfie.created
Occurs whenever a selfie is created.

selfie.submitted
Occurs whenever a selfie is submitted.

selfie.processed
Occurs whenever a selfie is processed.

selfie.errored
Occurs whenever a selfie’s processing has errored.

Session events

session.created
Occurs when a session is created.

session.expired
Occurs when a session expires.

Transaction events

transaction.created
Occurs whenever a transaction is created.

transaction.redacted
Occurs whenever a transaction is redacted.

transaction.status-updated
Occurs whenever a transaction’s status is updated.

transaction.labeled
Occurs when a transaction is labeled.

transaction.updated-fields
Occurs when one or more of a transaction’s fields are updated.

transaction.added-relation
Occurs when a relation is added to a transaction.

transaction.removed-relation
Occurs when a relation is removed from a transaction.

transaction.sentinel-session-processed
Occurs when a Sentinel session is processed for a transaction.

Transaction type events

transaction-type.deleted-field
Occurs when a field is deleted from a transaction type.

Verification events

verification.created
Occurs whenever a verification is created.

verification.submitted
Occurs when a verification is submitted.

verification.tentatively-passed
Occurs when a verification tentatively passes.

verification.tentatively-failed
Occurs when a verification tentatively fails.

verification.passed
Occurs when a verification passes.

verification.failed
Occurs when a verification fails.

verification.requires-retry
Occurs when a verification requires the individual to retry.

verification.canceled
Occurs when a verification gets canceled.

verification.skipped
Occurs when a verification is skipped.

verification.escalated
Occurs when a verification is escalated.

verification.updated-tags
Occurs when a verification’s tags are updated.

Workflow events

workflow.published
Occurs when a workflow is published.

Workflow run events

workflow-run.created
Occurs when a workflow run is created.

workflow-run.resumed
Occurs when a workflow run is resumed.

workflow-run.errored
Occurs when a workflow run errors.

User events

user.availability-updated
Occurs when a user’s availability is updated.

User notification events

user-notification.created
Occurs when a user notification is created.

user-notification.delivered
Occurs when a user notification is delivered.

user-notification.canceled
Occurs when a user notification is canceled.

user-notification.retracted
Occurs when a user notification is retracted.