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
Known 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
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp