Add a vendor bank account

Create a vendor bank account object.

Note: A vendor can have only one active bank account. You must delete a bank account (with /Crud/Delete/VendorBankAccount.json) before adding a new bank account.


This is an MFA protected endpoint. Create an MFA-protected API session with /Login.json before using /Crud/Create/VendorBankAccount.json.

What is a vendor bank account?

A vendor bank account is required for enabling electronic payments for the vendor. BILL encrypts and securely stores bank account and routing number information. Only the last four digits are visible with the API and Web app.

When you add a vendor bank account, the account status is 1 (Verified). BILL sends a test deposit to the bank account within one or two business days. This is to confirm whether the bank account is able to receive payments.

If the vendor bank account status is 3 (Blocked), 4 (Expired), or 5 (Invalid), the vendor’s payBy method for BILL payments is reverted to 0 (Check).

International vendors are vendors outside the US. You can add an international bank account for an international vendor. See Country information for international payments in the BILL Help Center to learn about supported countries and currencies.

Click Try It! to start a request and see the response here!