We have introduced a set of API endpoints for new bank account user operations. You can now nominate and archive bank account users.

When you nominate a bank account user, BILL sends the user an email asking them to sign in to the BILL web app and complete identity verification. After the verification is successful, the bank account user can pay with the specified bank account.

When you archive a bank account user, the user loses the ability to pay with the specified bank account.

OperationAPI endpoint
Nominate a bank account userPOST v3/funding-accounts/banks/users/nominate
Archive a bank account userPOST v3/funding-accounts/banks/users/{bankAccountUserId}/archive

We have added new API endpoints for general ledger classification bulk operations.

Departments

OperationAPI endpoint
Create multiple departmentsPOST /v3/classifications/departments/bulk
Update multiple departmentsPATCH /v3/classifications/departments/bulk
Archive multiple departmentsPOST /v3/classifications/departments/bulk/archive
Restore multiple departmentsPOST /v3/classifications/departments/bulk/restore

Jobs

OperationAPI endpoint
Create multiple jobsPOST /v3/classifications/jobs/bulk
Update multiple jobsPATCH /v3/classifications/jobs/bulk
Archive multiple jobsPOST /v3/classifications/jobs/bulk/archive
Restore multiple jobsPOST /v3/classifications/jobs/bulk/restore

Locations

OperationAPI endpoint
Create multiple locationsPOST /v3/classifications/locations/bulk
Update multiple locationsPATCH /v3/classifications/locations/bulk
Archive multiple locationsPOST /v3/classifications/locations/bulk/archive
Restore multiple locationsPOST /v3/classifications/locations/bulk/restore

We have added new API endpoints for general ledger classification bulk operations.

Accounting classes

OperationAPI endpoint
Create multiple accounting classesPOST /v3/classifications/accounting-classes/bulk
Update multiple accounting classesPATCH /v3/classifications/accounting-classes/bulk
Archive multiple accounting classesPOST /v3/classifications/accounting-classes/bulk/archive
Restore multiple accounting classesPOST /v3/classifications/accounting-classes/bulk/restore

Employees

OperationAPI endpoint
Create multiple employeesPOST /v3/classifications/employees/bulk
Update multiple employeesPATCH /v3/classifications/employees/bulk
Archive multiple employeesPOST /v3/classifications/employees/bulk/archive
Restore multiple employeesPOST /v3/classifications/employees/bulk/restore

We have added the capability for adding general ledger classifications to different BILL operations.

Invoices

When you create or update an invoice, you can now set your choice of general ledger classifications values (Accounting class, department, job, or location). In addition, you can set classifications at the line item level (Chart of accounts, accounting class, department, job, location, or item).

See /v3/invoices in the API reference for more information.

Bills

When you create or update an invoice, you can now set your choice of general ledger classifications values (Chart of accounts, accounting class, department, location, or item). In addition, you can set classifications at the line item level.

See /v3/bills in the API reference for more information.

Recurring bills

When you create or update a recurring bill, you can now set set classifications at the line item level.

See /v3/recurringbills in the API reference for more information.

Organization bank accounts

When you create or update a bank account, you can now set the chartOfAccountId field as the BILL-generated ID of the chart of accounts for the bank account.

See /v3/funding-accounts/banks in the API reference for more information.

We have added the capability for adding a chart of accounts to your bill and invoices.

  • Bills: When you create or update a bill, you can now set the payFromChartOfAccountId field as the BILL-generated ID of the chart of accounts for the bill payment.
  • Invoices: When you create or update an invoice, you can now set the payToChartOfAccountId field as the BILL-generated ID of the chart of accounts for the invoice payment.

We have added more API endpoints for general ledger classifications. These endpoints enable you to better maintain a General Ledger (GL) for bookkeeping and financial reporting.

Chart of accounts

Chart of accounts objects are lists of categories you use to classify and distinguish financial assets, liabilities, and transactions in your general ledger (GL).

OperationAPI endpoint
Create a chart of accountsPOST /v3/classifications/chart-of-accounts
Get list of chart of accountsGET /v3/classifications/chart-of-accounts
Get class of accounts detailsGET /v3/classifications/chart-of-accounts/{id}
Update a class of accountsPATCH /v3/classifications/chart-of-accounts/{id}
Archive a chart of accountsPOST /v3/classifications/chart-of-accounts/{id}/archive
Restore an archived chart of accountsPOST /v3/classifications/chart-of-accounts/{id}/restore

In addition, we have added list operations for the other categories.

OperationAPI endpoint
Get list of account classesGET /v3/classifications/accounting-classes
Get list of departmentsGET /v3/classifications/departments
Get list of employeesGET /v3/classifications/employees
Get list of itemsGET /v3/classifications/items
Get list of jobsGET /v3/classifications/jobs
Get list of locationsGET /v3/classifications/locations

BILL now maintains a 90-day event history for each subscription. You can get the list of event notifications sent to you for a subscription with GET /v3/events/subscription/{subscription_id}. You can now get the list of events for the last 90 days.