Webhook event types

Use this page to find the event names to put in a subscription's subscribedEvents, and to see what each event means.

This list reflects the Wingspan event catalog as of 2026-09-25. It contains 111 event types. We add events over time, so for the current list call GET /v3/platform/webhook-event-types and keep only entries where availableForSubscription is true. That endpoint also returns reserved names that aren't available yet (contractStatus: Planned); you can't subscribe to those, and a subscription that names one exactly is rejected with 422.

curl https://api.wingspan.app/v3/platform/webhook-event-types \
  -H "Authorization: Bearer $WINGSPAN_TOKEN"

// (trimmed)
{
  "data": [
    {
      "type": "Invoice.Paid",
      "contractStatus": "Published",
      "availableForSubscription": true,
      "resource": "Invoice",
      "domain": "payments",
      "payloadTier": "ResourceLifecycle",
      "moneyMovement": true,
      "allowedRoutingSubjectTypes": ["Account"],
      "description": "Emitted when Invoice records the Paid transition."
    }
  ]
}

How to read an event name

Every event type is {Resource}.{Event}, for example Invoice.Paid. The event part matches a timestamp on the resource: Invoice.Paid fires when the invoice gets its events.paidAt. You can subscribe to:

• An exact name: Invoice.Paid.
• Every event for one resource: Invoice.*.
• Every event: *.

A wildcard also picks up new event types for that resource as we publish them, so your handler should ignore types it doesn't recognize.

What's in each event

Every event is a small reference, not a copy of the resource. data carries the resource id and, for most events, its status and externalId. Fetch the resource from its API for the rest. Some events add one of these:

The Sent to column below lists the scope types that can receive each event (see Create a subscription). Events marked Both parties go to the payer's Account and the payee's Account as two separate events that share one occurrenceId.

Payments

FundsMovement

A single movement of money between accounts that backs a payment. Both the payer and the payee Account receive their own copy of each event.

GroupMember

A payee added to a payee group.

InternalAccount

A Wingspan-held financial account that belongs to an Account.

Invoice

A billing document. Both the payer and the payee Account receive their own copy of each event.

InvoicePayment

One payment attempt against an invoice. Events carry parent: { type: "Invoice", id } so you know which invoice it belongs to.

Mandate

An authorization to debit a funding source (for example, an ACH debit authorization).

Payable

A payment obligation from a payer to a payee. Both the payer and the payee Account receive their own copy of each event.

Payee

The payer-owned record of someone you pay.

PayrollSchedule

A payer's pay-period cadence configuration.

Finance

Statement

A periodic account statement.

Transaction

A ledger transaction on an Account's financial account.

Transfer

A transfer between an Account's own financial accounts or external bank accounts.

Compliance

BackgroundCheck

A background check ordered for a payee.

DocumentTemplate

A reusable document template used for e-signature.

InsuranceCoverage

A payee's insurance coverage record.

InsuranceImport

A bulk import of insurance coverage records.

InsuranceMonitor

Ongoing monitoring of a payee's insurance coverage.

SharedFileRequest

A request for a payee to upload a file.

SignatureRequest

A request for one or more parties to sign a document.

VaultFile

A file stored in the vault at /v3/compliance/vault-files.

Platform

Account

A business entity in Wingspan.

AccountingClass

A class record read from a connected accounting system.

AccountingConnection

A connection to an accounting system such as QuickBooks Online.

AccountingCustomer

A customer record read from a connected accounting system.

AccountingItem

An item record read from a connected accounting system.

AccountingVendor

A vendor record read from a connected accounting system.

ApiKey

An API key issued to a Person or a ServiceAccount.

ComplianceEntity

The verified legal identity (name, tax ID, address, and entity type) behind an Account or a Person. V1 called this a monitored entity, or ME.

Notification

A notification in a Person's inbox. Only a Person scope can receive these.

NotificationSubscription

An Account-level rule that routes notifications.

Operation

An AsyncOperation returned with a 202 Accepted. Poll GET /v3/platform/operations/{operationId} for the typed result.

Organization

A tenant that groups Accounts.

Role

A custom role definition. System roles never change, so they emit no events.

ServiceAccount

A machine identity owned by an Account or an Organization.

Events you might expect but won't find yet

Some events V1 users relied on, and some that appear in older design documents, aren't available for subscription yet. These include the other payee events (such as Payee.Created and Payee.Deactivated), payee link request events, engagement eligibility changes, Payout.*, Payable.DepositConfirmed, payroll run events, and tax form and filing events. Until they're published, read the resource directly or watch the related events above (for example, FundsMovement.* and Payable.Paid for money movement). Check GET /v3/platform/webhook-event-types for the current list.

Related pages

• Webhooks overview
• Create a subscription
• Paid vs DepositConfirmed
• Recover missed events