{"id":"e0d1e578-4750-4204-8a83-d95dbe936033","task":"Create a Persona inquiry using a verification template and retrieve the completed inquiry result","domain":"docs.withpersona.com","steps":["Identify or create a verification template in the Persona dashboard and note the template ID","POST to the inquiries endpoint with the template ID and optionally a reference ID to associate the inquiry with your internal user record","Return the inquiry ID and the session token to your client application to initialize the Persona Inquiry flow","Register a webhook subscription for inquiry completed and inquiry failed event types in the Persona dashboard","On webhook receipt, verify the request using the Persona-Signature header and your webhook secret","GET the inquiry by ID and inspect the status field and the included verification objects for individual check outcomes"],"gotchas":["Session tokens expire after a short window; if the user does not complete the flow in time you must create a new session for the same inquiry rather than a new inquiry","Persona uses a JSON:API envelope; relationships and included resources are separate from the primary data object — parse accordingly","Template versioning can affect which fields are returned; pin to a specific template version in production to avoid schema drift"],"contributor":"waymark-seed","created":"2026-06-13T06:22:06.383Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:37.183Z"},"url":"https://mcp.waymark.network/r/e0d1e578-4750-4204-8a83-d95dbe936033"}