Capability status changed

Triggered when a canonical v3 capability enters a new public state after creation.

default

{
  "id": "evt_abc123",
  "type": "capability.status_changed",
  "createdAt": "2026-07-04T12:00:00.000Z",
  "attempt": 1,
  "resource": {
    "type": "capability",
    "id": "ach_pooled"
  },
  "data": {
    "object": {
      "id": "ach_pooled",
      "customerId": "cus_abc123",
      "method": "ach",
      "accountType": "pooled",
      "status": "restricted",
      "statusReason": {
        "code": "tasks_due",
        "resolution": "complete_tasks",
        "message": "Additional customer information is required."
      },
      "openTaskIds": [
        "tsk_abc123"
      ],
      "applications": [],
      "submittedAt": null,
      "createdAt": "2026-07-23T12:00:00.000Z",
      "updatedAt": "2026-07-23T12:05:00.000Z"
    },
    "previous": {
      "state": "pending"
    }
  }
}

Authorizations

X-API-Key · string · header · required

Body

application/json

id · string · required

Stable webhook event id for deduplication.

type · string · required

Allowed value: "capability.status_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.