URL Expired

The URL for this request expired after 30 days.

subaccountId

uuid

required

Webhook trigger request

ids

array of uuids

required

length ≥ 1

List of bank transaction identifiers to emit webhooks for. Must contain at least one ID.

ids*
uuid

ADD uuid

webhooks

array of strings

The types of webhook events to emit.

webhooks

Allowed:

banktransaction.created``transaction.match.created

ADD string

forceRematch

boolean

Defaults to false

Set to true to re-run the matching algorithm for the named transactions before emitting webhooks. Transactions that already have a match are genuinely re-scored: the existing match id is preserved when the pairing survives, updated when a better pairing exists, and removed when the movement no longer matches.

truefalse

dispatchUnmatched

boolean

Defaults to false

After the re-match, emit the standalone bank-only feed entry for each named transaction the matcher left unmatched (idempotent per transaction — already-emitted standalones are skipped). Requires forceRematch: true and webhooks to include transaction.match.created; the request is rejected with 400 otherwise, because only a same-run re-match can distinguish a genuinely unmatched movement from a duplicate of an already-settled purchase.

truefalse

accept

string

enum

Defaults to application/json

Generated from available response content types

application/jsonapplication/problem+json

Allowed:

application/json``application/problem+json

`` 200 Webhooks triggered

object

message

string

required

Human-readable summary of the operation.

emitted

integer

required

Number of webhook events emitted.

resent

integer

required

Number of webhooks resent.

matched

integer

required

Number of transactions that were matched.

skipped

integer

required

Number of transactions that were skipped.

failed

array of objects

required

Transactions that failed to process.

failed*
object

id

string

The transaction identifier that failed.

error

string

The error message describing why processing failed.

dispatched

integer

Number of standalone bank-only emissions dispatched for still-unmatched transactions. Only present when dispatchUnmatched was requested (and on service versions that support the flag).

dispatchError

string

Present when the standalone dispatch step failed after a successful re-match; the matching results above still stand.

`` 400 The server cannot or will not process the request due to something that is perceived to be a client error

`` 401 Authentication credentials were either missing or incorrect

`` 403 Authentication credentials used do not have have permissions to perform the request

`` 500 The server encountered an unexpected condition that prevented it from fulfilling the request

Updated 12 days ago

ShellNodeRubyPHPPython

Bearer

xxxxxxxxxx

curl --request POST \

--url https://api.astrada.co/bank-transactions/subaccountId/webhooks \

--header 'accept: application/json' \

--header 'content-type: application/json' \

--data '

{

"ids": [],

"forceRematch": false,

"dispatchUnmatched": false

}

'

xxxxxxxxxx

{

"message": "Processed 1 transactions",

"emitted": 2,

"resent": 0,

"matched": 1,

"skipped": 0,

"failed": []

}

Updated 12 days ago