Complete a bank link
Finish linking a bank account through Plaid Link. Grid exchanges the publicToken, reads the account and routing numbers from Plaid, and checks that the bank lists the customer as the account’s owner: the customer’s full name for an INDIVIDUAL, or the business legal name for a BUSINESS.
On success Grid returns the customer’s external account for that bank account, creating it if the customer does not already have one with the same account and routing numbers, and records the account as validated for ACH. If the owner name does not match, Grid stores nothing and returns BANK_ACCOUNT_OWNER_MISMATCH.
Safe to retry with the same publicToken: a retry after success returns the same external account.
Authorizations
Body
Response
The bank account was already linked with this publicToken.
- AED Account
- BDT Account
- BRL Account
- BWP Account
- CAD Account
- COP Account
- DKK Account
- EGP Account
- EUR Account
- GBP Account
- GHS Account
- GTQ Account
- HKD Account
- HTG Account
- IDR Account
- INR Account
- JMD Account
- KES Account
- MWK Account
- MXN Account
- MYR Account
- NGN Account
- PHP Account
- PKR Account
- RWF Account
- SGD Account
- SLV Account
- THB Account
- TZS Account
- UGX Account
- USD Account
- VND Account
- XAF Account
- XOF Account
- ZAR Account
- ZMW Account
- SWIFT Account
- Base Wallet
- Ethereum L1 Wallet
- Lightning
- Polygon Wallet
- Plasma Wallet
- Arbitrum Wallet
- Optimism Wallet
- Avalanche Wallet
- Solana Wallet
- Spark Wallet
- Tron Wallet
- CNY Account
- ILS Account
- TRY Account
- CHF Account
- RON Account
- KRW Account
- AUD Account
- ARS Account
- CZK Account
- PLN Account
- SEK Account
Whether the external account belongs to the customer themselves (FIRST_PARTY) or to someone else (THIRD_PARTY). Required when creating self-custody crypto wallet external accounts on platforms subject to counterparty requirements — for example, under the EU Travel Rule or similar requirements in other regions; recommended for all other accounts, where providing it can unlock additional capabilities and smoother compliance handling.
FIRST_PARTY, THIRD_PARTY "FIRST_PARTY"
Whether this account is the default UMA deposit account for the customer. If true, incoming UMA payments to this customer's UMA address will be automatically deposited into this account instead of the primary internal account. False if not provided. Note that at most, one external account can be set as the default UMA deposit account for a customer. If there is no default UMA deposit account, incoming UMA payments will be deposited into the primary internal account for the customer.
false