Skip to main content
Use Persona through Corsair: one client, typed API calls, and incoming webhooks. Authenticate with the environment API key from the Persona dashboard (sandbox or production); the plugin sends it as an Authorization Bearer token and pins Persona-Version: 2023-01-05, the version its schemas follow (override with the apiVersion option). Every operation is a JSON:API call. Create and update bodies wrap fields in data.attributes; tag, decision and link options go in meta. Answers carry data (attribute keys in kebab-case, e.g. reference-id, created-at), plus included resources, and lists carry links.next: pass its page[after] value as pageAfter for the next page. Redactions, approvals and declines are final. One-time links let a holder resume an inquiry or session; anyone with the link can use it, so share it only with the intended holder. Webhook deliveries carry a Persona-Signature header of t=<unix time>,v1=<hex> sets: HMAC-SHA256 over “<t>.<raw body>” with the webhook’s secret, one set per active secret while it rotates. Sets whose timestamp is more than 5 minutes from now are refused, so an old signed delivery can’t be replayed. webhooks.create and webhooks.rotateSecret return the secret; store it with keys.set_webhook_signature (or set webhookSecret on the plugin). The delivery body is { data: { type: “event”, attributes: { name, payload } } }. The Persona API has 200+ operations; this plugin covers accounts, inquiries, inquiry sessions, inquiry templates, and webhook management. The verification sub-types (AAMVA, database businesses, government IDs), lists, reports, transactions and devices are documented by Persona but not part of this plugin. Every operation is described in the official reference: https://docs.withpersona.com/2023-01-05/api-reference What you get:
  • 36 typed API operations
  • 1 incoming webhook event types

Setup

1

Install

2

Add the plugin

corsair.ts
With multiTenancy: true, scope calls with corsair.withTenant(id). See Quick start for KEK + Hub keys, and Multi-tenancy for account isolation.
3

Choose authentication

4

Connect a tenant

Mint a connect link and send the tenant to it. Hub hosts the page and delivers the result to your app — see Connect / OAuth.

Example API calls

Read an inquiry
Create an inquiry
See the full list on the API page.

Webhooks

This plugin registers 1 webhook event type. Configure the provider to POST to your Corsair HTTP handler, then use webhookHooks on the plugin factory. See Webhooks for every event path and payload shape, and Webhooks concept for routing.

What’s next

API reference

Every persona.api.* operation with input and output types.

Webhooks

Event paths, payloads, and webhookHooks examples.

Connect / OAuth

createLink, Hub delivery, and tenant connect flows.

Use with agents

Expose this plugin’s operations as MCP tools.