Create multiple vendors

Create multiple vendors in one 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.

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