Overview

An event is Natural’s record that something happened on your account: each one names what occurred and carries a point-in-time snapshot of the resource it describes. Events are what Webhooks deliver to your server; the endpoints below let you list and fetch the same events on demand.

The event object

The API returns events as standard resources. The eventType attribute names what happened, and the resource snapshot lives at payload.object:

{
  "data": {
    "type": "event",
    "id": "evt_019cd3444a7a70efaf554fd8450d221a",
    "attributes": {
      "eventType": "wallet.created",
      "resourceId": "wal_019cd3444a7a70efaf554fd8450d334b",
      "resourceType": "wallet",
      "payload": {
        "object": {
          "partyId": "pty_019cd34e27bf78399b4e75b327d2ab25",
          "walletType": "standard",
          "status": "active",
          "displayName": "My Wallet",
          "currency": "usd"
        }
      },
      "createdAt": "2026-01-15T14:30:00Z"
    },
    "relationships": {
      "party": {
        "data": { "type": "party", "id": "pty_019cd34e27bf78399b4e75b327d2ab25" }
      }
    }
  }
}

Webhook deliveries carry the same event in a flat body: there, type names the event and the snapshot lives at data.object. See Webhooks for the delivery format, signature verification, and retries. The Event catalog documents every event type and the full snapshot payload it carries.

Delete webhook Event catalog

⌘I

Agents

Customers

Payments

Transactions

Transfers

Payment Requests

Approvals

Limits

Parties

Party Invitations

Wallets

Wallet Access

External Accounts

API keys

Agent keys

Webhooks

Events

Errors

Overview

The event object

​The event object

The event object