openapi: 3.1.0
info:
  title: Persona Accounts Webhooks API
  description: 'The Persona API enables identity verification, fraud prevention, and

    Know Your Customer (KYC) workflows. Use the API to create and manage

    inquiries, accounts, verifications, reports, transactions, lists, and

    webhooks for verifying users via document checks, selfie checks, and

    database lookups.

    '
  version: 2025-12-08
  contact:
    name: Persona Support
    url: https://docs.withpersona.com/docs/support
  termsOfService: https://withpersona.com/legal/terms-of-service
servers:
- url: https://withpersona.com/api/v1
  description: Persona production API
tags:
- name: Webhooks
  description: Manage webhook subscriptions for asynchronous event delivery.
paths:
  /webhooks:
    get:
      operationId: listWebhooks
      summary: List all Webhooks
      tags:
      - Webhooks
      security:
      - bearerAuth: []
      responses:
        '200':
          description: A list of webhooks.
    post:
      operationId: createWebhook
      summary: Create a Webhook
      tags:
      - Webhooks
      security:
      - bearerAuth: []
      responses:
        '201':
          description: Webhook created.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'Persona uses bearer-token authentication. Pass your API key as

        `Authorization: Bearer <YOUR_API_KEY>` on every request.

        '
externalDocs:
  description: Persona API Reference
  url: https://docs.withpersona.com/reference/introduction