/v1/accounting/bank-transactionsRecord a bank transaction
Imports a batch of bank lines, which is how money that has actually arrived enters the books. Body: transactions, an array of at least one and at most 1000 entries of {externalId, source, postedOn (required, YYYY-MM-DD), currency, amountMinor, accountName, accountLast4, description, memo}. The whole batch runs in one transaction and it is idempotent by externalId — a line already present is skipped, not refused, so importing August twice leaves August alone; the answer says how many were imported and how many skipped. Importing a line credits no deal on its own: that is a separate allocation (post_accounting_allocations). Takes the brokerage's books: an owner or admin, or a seat holding an accounting grant (get_accounting_me_access); anyone else is refused with 403. A hand import belongs to no linked account, so it needs a grant that reaches every account.
Access class: workspace:books.
Send request
Use the documented inputs to call this endpoint directly.
Request body
application/jsonrequiredResponses
the action's answer
{
"data": {
"imported": 1,
"skipped": 1
}
}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}