Create a transfer
POST/transfers
Creates an account-to-account transfer as a linked debit/credit pair sharing one transfer_id. Requires scope finance.transactions.write. The two accounts must differ, both must belong to the tenant, and both must have a linked company (cross-company is allowed). Pass an X-Idempotency-Key header on retries.
Request
Responses
- 201
- 400
- 401
- 403
- 404
- 409
- 422
- 500
Transfer created. The Location header points at GET /transfers/{transfer_id}.
Malformed JSON body.
Missing / invalid / expired / revoked token.
Token lacks the finance.transactions.write scope.
A source/destination account was not found within the tenant.
X-Idempotency-Key reuse with a different body.
Schema validation failure, same source/destination account, non-positive amount, or an account without a linked company.
Unhandled server error.