Webhook event

`saved_address.active`

The wait is over; payouts to it can be requested.

Type: saved_address.active
The object it carries: the saved_address object
Subscribe with: saved_address.active, saved_address.* or *

Example payload

The body of the request your endpoint receives, shown here over several lines. On the wire it is compact JSON; check its signature over the bytes exactly as they arrive.

Example payload

{
  "id": "evt_7b537r0fdzc07bdrq95stqmx",
  "object": "event",
  "livemode": true,
  "created": "2026-10-05T11:20:00.000Z",
  "type": "saved_address.active",
  "api_version": "2026-10-11",
  "data": {
    "object": {
      "id": "dst_92jw0br3z1bzkk45ddjqcm6q",
      "object": "saved_address",
      "livemode": true,
      "created": "2026-10-05T11:20:00.000Z",
      "label": "Green bean supplier",
      "kind": "third_party",
      "address": "0xD1220A0cf47c7B9Be7A2E6BA89F429762e7b9aDb",
      "network": "base",
      "asset": "base:usdc",
      "status": "active",
      "approved_by": "mem_ceh1wpzdrpk13cnpcjy9w0fa",
      "approved_at": "2026-10-05T11:24:09.000Z",
      "usable_at": "2026-10-06T11:24:09.000Z",
      "screening": {
        "id": "scr_6ncr4e0p7wqndfvny2d5vw5s",
        "status": "clear",
        "checked_at": "2026-10-05T11:20:01.000Z"
      },
      "approval_url": null,
      "metadata": {}
    },
    "previous_attributes": {
      "status": "waiting"
    }
  },
  "request": {
    "id": null,
    "idempotency_key": null
  },
  "pending_webhooks": 1
}

Fields of data.object

Fields of data.object in saved_address.active
Field	In this example
`id`	`"dst_92jw0br3z1bzkk45ddjqcm6q"`
`object`	`"saved_address"`
`livemode`	`true`
`created`	`"2026-10-05T11:20:00.000Z"`
`label`	`"Green bean supplier"`
`kind`	`"third_party"`
`address`	`"0xD1220A0cf47c7B9Be7A2E6BA89F429762e7b9aDb"`
`network`	`"base"`
`asset`	`"base:usdc"`
`status`	`"active"`
`approved_by`	`"mem_ceh1wpzdrpk13cnpcjy9w0fa"`
`approved_at`	`"2026-10-05T11:24:09.000Z"`
`usable_at`	`"2026-10-06T11:24:09.000Z"`
`screening`	An object with `id`, `status`, `checked_at`
`approval_url`	`null`
`metadata`	An object with no fields

What each field means is on the page of the saved_address object. data.previous_attributes holds the old values of exactly the fields that changed: here status.

Endpoints behind it

Calls that change saved addresses. An event is also sent when a payer, the network, a timer or a person in the dashboard causes the change; the sentence above says which.