Transaction webhooks communicate changes in the transaction history for a particular item. This can include the removal of transactions, update to transactions, and new transactions associated with the account.

An Account Was Linked and Initial Transactions Are Available.

After an item is linked for the first time, a large amount of new transaction data for the last 30 days is retrieved for the newly-linked Item. This webhook lets developers know that the new data is now retrievable in the API.

Subscribing

Receiving

Parameters

Webhook

Example Webhook

{
  "webhook_type": "TRANSACTIONS",
  "webhook_code": "INITIAL_UPDATE",
  "item_id": "wz666MBjYWTp2PDzzggYhM6oWWmBb",
  "error": null,
  "new_transactions": 19
}

Historical Transactions are Available.

After a developer asks for a large number of historical transactions, a webhook for the item the request was made on will fire, notifying the developer that the transactions are now available

Subscribing

Receiving

Parameters

Webhook

Example Webhook

{
  "webhook_type": "TRANSACTIONS",
  "webhook_code": "HISTORICAL_UPDATE",
  "item_id": "wz666MBjYWTp2PDzzggYhM6oWWmBb",
  "error": null,
  "new_transactions": 231
}