generated: '2026-07-19'
method: searched
source: https://docs.finsify.com/
spec_type: Webhooks
transport: HTTP POST callback to a partner-registered URL
description: >-
Finsify Hub pushes asynchronous notifications to a partner-registered callback
URL. Two event families are documented: new-transaction notifications when
fresh transactions are synced for a login, and login-status-change
notifications when an end-user's bank login can no longer be refreshed.
events:
- name: new_transaction
summary: New transactions were synced for a login.
payload_fields:
- login_id
- timestamp
- accounts
- new
- referenceId
- name: login_status_change
summary: An end-user bank login changed status and may need re-authentication.
payload_fields:
- status
- login_id
statuses:
- value: login_wrong_credentials
meaning: Login changed password / credentials no longer valid
- value: login_password_expired
meaning: Login password is expired
- value: login_account_locked
meaning: Login is locked
remediation:
note: >-
On a login_status_change event, call POST /token/reconnect to prompt the
end-user to re-authenticate the affected bank login.