Account updated webhook
info
📘 To learn more about webhooks in our API, follow the link below:
This page describes the ACCOUNT_STATUS_UPDATED webhook, which fires whenever a change occurs to a registered account.
Headers
| Name | Description |
|---|---|
| x-delbank-api-key | Required. API key |
| x-delfinance-account-id | Required. The Delfinance bank account number |
Body
{
"bankAccount": "999999",
"eventType": "ACCOUNT_STATUS_UPDATED",
"url": "your.url.test.com",
"authorization": "NONE",
"authorizationScheme": "NONE"
}
Sample response when the webhook is created:
{
"id": 1234,
"bankAccount": "999999",
"eventType": "ACCOUNT_STATUS_UPDATED",
"url": "your.url.test.com",
"authorization": "NONE",
"externalId": null,
"createdAt": "2025-03-02T12:14:06.0613001Z",
"updatedAt": "2025-03-02T12:14:06.0613227Z",
"authorizationScheme": "NONE"
}
💡 The webhook uses the same schema when delivering events; you can reuse this object as a reference.
Example event payload
{
"bankAccount": "999999",
"eventType": "ACCOUNT_STATUS_UPDATED",
"status": "BLOCKED",
"updatedAt": "2026-03-06T13:31:47.9997672Z"
}
Attributes delivered by ACCOUNT_STATUS_UPDATED
| Name | Description |
|---|---|
| bankAccount | The Delfinance account number whose information changed |
| eventType | The type of event that triggered the webhook (always ACCOUNT_STATUS_UPDATED) |
| status | Current status of the account (e.g. ACTIVE, BLOCKED) |
| updatedAt | Timestamp when the change occurred |