Create a Persona inquiry and handle webhook results for identity verification

Steps

1. Authenticate all requests by adding your Persona API key as the Authorization header value (format: YOUR_API_KEY) and set the Persona-Version header to your chosen API version.
2. Create an inquiry by POST-ing to the /api/v1/inquiries endpoint with a body specifying the inquiry_template_id and optionally pre-filling reference_id and attributes such as name and email.
3. Return the inquiry_id and the hosted flow URL (or session token for embedded flows) to your frontend so the user can complete document upload and selfie capture.
4. Register a webhook endpoint in the Persona dashboard pointing to your server; Persona will POST inquiry.completed, inquiry.approved, and inquiry.declined events.
5. On receiving a webhook, verify the request signature using the webhook secret from your dashboard, then fetch the full inquiry via GET /api/v1/inquiries/{inquiry_id} to read verification details.
6. Store the inquiry status and any extracted document fields (name, date of birth, document number) against your user record and trigger downstream onboarding logic.