Astra sends webhooks whenever there are new or removed transactions associated with an account.

Transactions Initial Update

Fired when an accounts initial transaction pull is completed. This will include the most recent 30 days of transactions for a particular account.

ParameterData TypeDescription
webhook_typestringtransactions_initial_update
webhook_idstringThe unique ID of the webhook event
user_idstringThe unique ID of the User
resource_idstringThe unique ID of the Resource (Account ID)

Example:

{
  "webhook_type": "transactions_initial_update",
  "webhook_id": "364f57aa-47dd-461b-8df4-d6388fb2d05e",
  "user_id": "0239decedaaa5cefa4d173ee839ca37599165219",
  "resource_id": "WV9Zwexqw7Tqk8nox5dBSe993dEBqGulDlnNA"
}

Transactions Historical Update

Fired when an accounts historical transaction pull is completed. This may include up to 2 years of transactions for a particular account.

ParameterData TypeDescription
webhook_typestringtransactions_historical_update
webhook_idstringThe unique ID of the webhook event
user_idstringThe unique ID of the User
resource_idstringThe unique ID of the Resource (Account ID)

Example:

{
  "webhook_type": "transactions_historical_update",
  "webhook_id": "364f57aa-47dd-461b-8df4-d6388fb2d05e",
  "user_id": "0239decedaaa5cefa4d173ee839ca37599165219",
  "resource_id": "WV9Zwexqw7Tqk8nox5dBSe993dEBqGulDlnNA"
}

Transactions Default Update

Fired when new transaction data is available for an Account.

ParameterData TypeDescription
webhook_typestringtransactions_default_update
webhook_idstringThe unique ID of the webhook event
user_idstringThe unique ID of the User
resource_idstringThe unique ID of the Resource (Account ID)

Example:

{
  "webhook_type": "transactions_default_update",
  "webhook_id": "364f57aa-47dd-461b-8df4-d6388fb2d05e",
  "user_id": "0239decedaaa5cefa4d173ee839ca37599165219",
  "resource_id": "WV9Zwexqw7Tqk8nox5dBSe993dEBqGulDlnNA"
}

Transactions Removed Update

Fired when transaction(s) for an Account are deleted.

ParameterData TypeDescription
webhook_typestringtransactions_removed
webhook_idstringThe unique ID of the webhook event
user_idstringThe unique ID of the User
resource_idstringThe unique ID of the Resource (Account ID)
removed_transactionsarrayThe list of removed Transaction IDs

Example:

{
  "webhook_type": "transactions_removed",
  "webhook_id": "364f57aa-47dd-461b-8df4-d6388fb2d05e",
  "user_id": "0239decedaaa5cefa4d173ee839ca37599165219",
  "resource_id": "WV9Zwexqw7Tqk8nox5dBSe993dEBqGulDlnNA",
  "removed_transactions": [
    "1bEkPW7wmpSmE1K18X78H8gJ3l3PvpuQNARwK",
    "3yA7QJkvdgTPAplpr4NrHrQ1yDKgV5FwQd6jo"
  ]
}