Account details changed

Triggered when the current routing instructions for an issued v3 bank account change.

default

{
  "id": "evt_abc123",
  "type": "account.details_changed",
  "createdAt": "2026-07-04T12:00:00.000Z",
  "attempt": 1,
  "resource": {
    "type": "account",
    "id": "acc_abc123"
  },
  "data": {
    "object": {
      "id": "acc_abc123",
      "customerId": "cus_abc123",
      "type": "bank",
      "method": "wire",
      "origin": "issued",
      "status": "ready",
      "openTaskIds": [],
      "currency": "USD",
      "details": {
        "routingNumber": "021000021",
        "accountNumber": "123456789",
        "accountType": "checking",
        "bankName": "Example Bank",
        "accountHolderName": "Swipelux",
        "reference": "WIRE-ABC123",
        "referenceRequired": true
      },
      "routing": {
        "version": 1788634000000,
        "validFrom": "2026-09-05T01:00:00.000Z",
        "validUntil": null
      },
      "fees": {
        "breakdown": {
          "developer": {
            "fixed": "1.00",
            "bips": 50
          }
        }
      },
      "createdAt": "2026-07-04T12:00:00.000Z",
      "updatedAt": "2026-09-05T01:00:00.000Z",
      "archivedAt": null
    },
    "previous": {
      "routingVersion": 1788630400000
    }
  }
}

Authorizations

X-API-Key · string · header · required

Body

application/json

id · string · required

Stable webhook event id for deduplication.

type · string · required

Allowed value: "account.details_changed"

createdAt · string<date-time> · required

attempt · enum<integer> · required

Envelope attempt value; currently always 1 and unchanged by delivery retries.

Available options: 1

resource · object · required

Show child attributes

data · object · required

Show child attributes

Response

200

Webhook accepted by the merchant endpoint.