Skip to main content

Account Event Webhook Response

Our webhooks keep you updated in real-time about important events related to account creation and closing. By using these webhooks, you can create applications that quickly respond to changes in account statuses.

The JSON body structure of an Account Event webhook call that you will receive, is as follows:

curl -L 'https://example-url.com/ach-payments-api/v1/{your-webhook-url}' \
-H 'Content-Type: application/json' \
-H 'Authorization: Basic PHVzZXJuYW1lPjo8cGFzc3dvcmQ+' \
-d '{
"notificationId": "38e5a079-d38c-4bd3-9cd1-22b31f35ee4c",
"eventType": "acct.status",
"eventDateTime": "2025-07-31T07:08:31.527-07:00",
"data": {
"accountStatusEventInfo": {
"accountId": "123456789",
"accountType": "D",
"action": "Create",
"exceptionInfo": []
}
}
}
URL

The your-webhook-url will be the full FDNS custom HTTP endpoint that provided during your onboarding.

The section below describes the parameters and objects present in the request.

Body Parameters

notificationIdstringrequired

Unique ID of the notification.

eventTypestringrequired

The type of event that triggered the notification.

eventDateTimestringrequired

Timestamp of when the event occurred.

dataobjectrequired
Show properties
accountStatusEventInfoobjectrequired
Show properties
accountIdstringrequired

The ID of the account.

accountTypestringrequired

The type of the account.

actionstringrequired

The action performed on the account.

exceptionInfoarrayrequired
Show properties
[]object

Details about any exceptions related to the account status change.