--- title: "Inquiry created" method: POST path: "inquiryEvents_webhook-inquiry-created" --- # Inquiry created `POST inquiryEvents_webhook-inquiry-created` (webhook) Webhook for the `inquiry.created` event. For more info see [Webhooks Overview](https://docs.withpersona.com/webhooks). ## Headers - `Persona-Signature` string - `Persona-Webhook-Attempts-Made` integer - `Persona-Webhook-Attempts-Left` integer - `Persona-Webhook-First-Attempted-At` integer ## Payload - object - `data` WebhooksWebhookInquiryCreatedPayloadContentApplicationJsonSchemaData - `type` 'event' - `id` string: Unique identifier for this Event. Starts with `evt_`. - `attributes` WebhooksWebhookInquiryCreatedPayloadContentApplicationJsonSchemaDataAttributes - `created-at` string, date-time: Datetime when the event was created. - `name` 'inquiry.created' - `payload` WebhooksWebhookInquiryCreatedPayloadContentApplicationJsonSchemaDataAttributesPayload - `data` Inquiry: An Inquiry object - `id` string, required - `attributes` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryAttributes, required - `status` string, required: The status of the Inquiry Possible values: - created - pending - completed - expired - failed - needs_review - approved - declined Do not assume this is a static enumeration; Persona may add new values in the future without a versioned update. - `reference-id` string, nullable, required - `note` string, nullable, required - `behaviors` object, nullable, required: Risk signals surfaced to enterprise customers. Specific keys are not enumerated in the public spec and may be added or removed over time. Contact your Persona account team for more information. - `tags` string[], required - `creator` string, required - `reviewer-comment` string, nullable, required - `created-at` string, date-time, required - `updated-at` string, date-time, required - `started-at` string, date-time, nullable, required - `expires-at` string, date-time, nullable, required - `completed-at` string, date-time, nullable, required - `failed-at` string, date-time, nullable, required: Set when an Inquiry transitions to `failed`. Not typically set on `declined` Inquiries — those carry `completed-at` from the transition that preceded the decision. - `marked-for-review-at` string, date-time, nullable, required - `decisioned-at` string, date-time, nullable, required - `expired-at` string, date-time, nullable, required - `redacted-at` string, date-time, nullable, required - `previous-step-name` string, nullable, required - `next-step-name` string, nullable, required - `fields` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryAttributesFields, required: JSON key-value pairs of field name to field value. Exact schema depends on the configuration of the Inquiry template for this Inquiry. Keys in `fields` are **not** key inflected. - … - `relationships` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationships, required - `account` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsAccount - … - `documents` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsDocuments - … - `template` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsTemplate: Only present for Legacy 2.0 inquiries - … - `inquiry-template` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsInquiryTemplate: Only present for Dynamic Flow inquiries - … - `inquiry-template-version` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsInquiryTemplateVersion: Only present for Dynamic Flow inquiries - … - `reports` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsReports - … - `transaction` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsTransaction - … - `reviewer` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsReviewer: Actor that decisioned the Inquiry. `data` is `null` while the Inquiry has not been decisioned. Once decisioned, `data.type` and `data.id` identify the reviewer: - `user` + `user_*` — a dashboard user reviewed and decisioned the Inquiry. - `workflow` + `wfl_*` — Workflows 1.0 auto-decisioned the Inquiry. - `workflow-run` + `wfr_*` — Workflows 2.0 auto-decisioned the Inquiry (the dominant case in automation-heavy organizations). - … - `selfies` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsSelfies - … - `sessions` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsSessions - … - `verifications` SelfieIncludedObjectsItemsDiscriminatorMappingInquiryRelationshipsVerifications - … - `included` InquiryIncludedObjectsItems[] - union - object: An Account object. Note that `fields` is **not** key inflected. - … - object: A Document Generic object - … - object: A Document Government ID object - … - object: A Document Government ID NFC object - … - object: A Document Mdoc object - … - object: A User object - … - object: An Inquiry Template object - … - object: An Inquiry Template Version object - … - object: An Template object for legacy inquiries - … - object: An Address Lookup Report - … - object: An Adverse Media Report - … - object: A report detailing adverse media findings for a business entity. - … - object: A report containing information about the Associated Persons of a business entity - … - object: A report containing business registration information from official sources - … - object: A Business Lookup Report - … - object: A Business Media Coverage Report - … - object: A Business Nonprofit Report - … - object: A Business Search Report - … - object: A Business Watchlist Report - … - object: A Crypto Address Watchlist Report - … - object: An Email Address Report - … - object: An IP Address Report. The outcome is exposed through the shared `status` (`ready` or `errored`) and `has-match` attributes; `result.error` describes why an errored report could not complete. - … - object: A Phone Risk Report - … - object: A Politically Exposed Person Report - … - object: A Profile Report - … - object: A Profile Non-Authoritative Report - … - object: A SentiLink Scores Report - … - object: A Social Media Report - … - object: A Synthetic Report - … - object: A Watchlist Report - … - object: A Selfie object - … - object: A Selfie object - … - object: A Selfie object - … - object: inquiry-session variant - … - object: transaction variant - … - object: An AAMVA Verification - … - object: A Bank Pennydrop Verification - … - object: A Brand Asset Verification - … - object: A Business Website Verification - … - object: A Certificate Korea Verification - … - object: A Credit Card Verification - … - object: A Crypto Wallet Verification - … - object: A Database Verification - … - object: A Database Aadhaar Verification - … - object: A Database Business Verification - … - object: A Database Business Footprint Verification - … - object: An eCBSV Database Verification - … - object: A Phone Carrier Database Verification - … - object: A Serpro Database Verification - … - object: A Standard Database Verification - … - object: A TIN Database Verification - … - object: A Database VAT Number Verification - … - object: A Digital ID Connect ID Verification - … - object: A Digital ID e-do App Verification - … - object: A Digital ID Finnish Trust Network Verification - … - object: A Digital ID France Identite Verification - … - object: A Digital ID Generic Verification - … - object: A Digital ID iDIN Verification - … - object: A Digital ID itsme Verification - … - object: A Digital ID KCB Credit Card Verification - … - object: A Digital ID MitID Verification - … - object: A Digital ID Northern Ireland Drivers License Check Code Verification - … - object: A Digital ID One ID Verification - … - object: A Digital ID PhilSys Verification - … - object: A Digital ID SERPRO Verification - … - object: A Digital ID Singpass Verification - … - object: A Digital ID Swedish BankID Verification - … - object: A Digital ID UK Sharecode Verification - … - object: A Digital ID World ID Verification - … - object: A Document Verification - … - object: An Email Address Verification - … - object: A Government ID Verification - … - object: A Government ID NFC Verification - … - object: A Japanese My Number Card NFC Scan Verification - … - object: An mDoc (mobile document) Verification - … - object: A Persona FFF Inquiry Verification - … - object: A Phone Number Verification - … - object: A Phone Number Silent Network Authentication Verification - … - object: A Qualified Electronic Signature (QES) Verification via InfoCert - … - object: A Selfie Verification - … - object: A W3C Verifiable Credential Verification - … - object: A Workflow object - … - object: A Workflow Run object - … ## Acknowledgement `200` Webhook received successfully --- [API](https://skmtc.dev/withpersona/apis/withpersona-5.md) - [All operations](https://skmtc.dev/withpersona/apis/withpersona-5/llms.txt) - [OpenAPI document](https://skmtc.dev/withpersona/apis/withpersona-5/revisions/0281de74819e?raw)