Post Pool Bank Accounts By Bank Account Id Replace Autoexchange
AuthorizationBearer <token>Scope: pool-bank-accounts:write
bank_account_id*stringIdempotency-Key*stringUnique key making the create idempotent across retries (16-64 chars of A-Z a-z 0-9 _ -).
^[a-zA-Z0-9_-]{16,64}$application/json- body
Create an account-level pool bank account (pool_balance). asset and network are required. There is no bank_type field — the type is forced server-side. External-rail identifiers (IBAN, BIC/SWIFT, wire/FFC messages) are not collected on pool bank accounts.
asset*stringSettlement asset / currency, e.g. USD.
network*stringPayment rail, e.g. ach, wire, pix.
bank_name?stringaccount?stringAccount number.
routing_number?stringRouting number (e.g. US ABA).
bank_short_description?stringOptional human-readable label.
bank_code?stringbranch?stringbank_address?stringbank_city?stringbank_state?stringbank_postal_code?stringinstant_payment?stringinstant_payment_type?stringcountry?stringdeposit_reference?stringautoexchange?booleanWhen true, funds received on this account are auto-exchanged and settled to autoexchange_destination_wallet_id.
falseautoexchange_destination_wallet_id?|Wallet (wal_…) that receives auto-exchanged funds. Required when autoexchange is true.
The old autoexchange pool bank account was soft-deleted and this replacement created in the same transaction.
application/json- response
An account-level pool bank account (pool_balance). Has no subaccount. Returned by pool create, pool replace-autoexchange, pool get-by-id, and as each element of the pool list.
id*stringBank account ID (bnk_…).
account_id*stringOwning account ID (acc_…).
asset*stringbank_type*"pool_balance""pool_balance"bank_name?stringaccount?stringrouting_number?stringbank_short_description?stringbank_code?stringbranch?stringnetwork*stringinstant_payment?stringinstant_payment_type?stringcountry?stringdeposit_reference?stringcompliance_status*stringunchecked on creation.
is_active*booleanautoexchange*booleanautoexchange_destination_wallet_id?stringDestination wallet for auto-exchange, when configured.
created_at*stringdate-timeupdated_at*stringdate-timecurl -X POST 'https://api.betaramps.com/pool/bank-accounts/string/replace-autoexchange' \ -H 'Idempotency-Key: string' \ -H 'Content-Type: application/json' \ -d '{ "asset": "USD", "network": "ach", "bank_name": "JPMorgan Chase", "account": "000123456789", "routing_number": "021000021", "bank_code": "CHASUS33", "branch": "0002", "country": "US", "autoexchange": true, "autoexchange_destination_wallet_id": "wal_0192f4e6-1a2b-7c3d-8e4f-5a6b7c8d9e01"}'{ "id": "bnk_0192f5b2-5e6f-7a7b-8c9d-0e1f2a3b4c45", "account_id": "acc_0192f4e0-1a2b-7c3d-8e4f-5a6b7c8d9e01", "asset": "USD", "bank_type": "pool_balance", "bank_name": "JPMorgan Chase", "account": "000123456789", "routing_number": "021000021", "bank_code": "CHASUS33", "branch": "0002", "network": "ach", "country": "US", "compliance_status": "unchecked", "is_active": true, "autoexchange": true, "autoexchange_destination_wallet_id": "wal_0192f4e6-1a2b-7c3d-8e4f-5a6b7c8d9e01", "created_at": "2026-10-31T12:00:00Z", "updated_at": "2026-10-31T12:00:00Z"}