Create multiple vendors

Create multiple vendors with one API request. You can create up to 20 vendors with one POST /v3/vendors/bulk request.

In your bulk vendor creation request, all your vendors must be successfully created for a successful response. If any vendor creation is not successful, the entire request fails and none of the vendors in the request are created.

Requirements for enabling vendor payments

Vendor address details are required for paying a vendor by check or for inviting the vendor to join the BILL network.

• line1
• city
• zipOrPostalCode
• country
• payeeName

Requirements for enabling electronic payments to vendors

Vendor bank account details are required for paying a vendor with electronic payment methods.

paymentInformation details about bank accounts are required for adding a vendor bank account.

• payeeName
• bankCountry (for international vendors)
• paymentCurrency (for international vendors)
• nameOnAccount
• accountNumber
• routingNumber (empty for an IBAN accountNumber)
• type (for international vendors)

regulatoryFields and paymentPurpose are additional required fields for enabling electronic payments to international vendors (not United States) in specific countries.

Note: When you add vendor bank account information, BILL requires 2 business days to complete a one-time verification of the bank account. Payments sent to the vendor are processed after the one-time verification is complete. See Get list of vendor payment options to get details about vendor payment options and payment process dates.

See Vendors in the Guides section for more information, sample requests, and responses.