We have added a new developer tutorial - Bill approvals with the BILL v3 API - in the BILL API Platform for developers YouTube playlist. See the BILL API Platform for developers playlist for the complete set of developer tutorials.
In this tutorial, we walk through how to build and manage bill approval workflows using the BILL v3 API.
We have added a new Postman Notebook for the BILL AR workflow with the BILL v3 API. See the BILL AR Workflow Postman Notebook for details.
In this notebook, you build an API workflow that enables you to set up a customer record in your BILL organization, create an invoice for the customer, and then charge the customer to get paid for the invoice.
In all, we now have 4 published Postman Notebooks.
We have improved the table of contents in the BILL v3 API API reference section on developer.bill.com.
You now see dedicated sections for Accounts Payable (AP) and Accounts Receivable (AR) operations. Other operations that belong to your BILL organization are now in the new Organization Operations section. There is no change in any of the other sections in the API reference.
These improvements are also available in the BILL v3 API Postman Collection.
We have added a new Postman Notebook for the BILL expense management workflow with users, budgets, and cards. See the BILL Expense Management with Users, Budgets, & Cards Postman Notebook for details.
In this notebook, you build an API workflow that enables you to set up a Spend & Expense budget, assign a user to the budget, and create a virtual card for the user to stick to their budget.
In all, we now have 3 published Postman Notebooks.
We have introduced a set of API endpoints for charging customers. You can now use the BILL v3 API to charge a customer for one or more invoices.
| Operation | API endpoint |
|---|---|
| Set charge customer authorization | POST /v3/customers/{customerId}/charge-authorization |
| Charge a customer | POST /v3/receivable-payments |
We have updated the webhooks events catalog to include a set of new events for invoices. Notifications are now triggered for these invoice events. You can now set up subscriptions to receive notifications for the new events.
| Event | Description |
|---|---|
invoice.created | An invoice is created |
invoice.updated | An invoice is updated |
invoice.archived | An invoice is archived |
invoice.restored | An archived invoice is restored |
See Invoice notification payloads for more information.
We have added a list of BILL ACH IDs in the Manage funding list. This information is required in case the user's bank account has a debit block or debit filter. The user can now easily access this information in the Manage funding list experience. The user can copy the BILL ACH ID values to clipboard.
We have introduced a set of API endpoints for customer bank accounts. You can now use the BILL v3 API to create and manage customer bank account information.
| Operation | API endpoint |
|---|---|
| Create a customer bank account | POST /v3/customers/{customerId}/bank-accounts |
| Update a customer bank account | PATCH /v3/customers/{customerId}/bank-accounts/{bankAccountId} |
| Get customer bank account details | GET /v3/customers/{customerId}/bank-accounts/{bankAccountId} |
| Get list of customer bank accounts | GET /v3/customers/{customerId}/bank-accounts |
| Archive a customer bank account | POST /v3/customers/{customerId}/bank-accounts/{bankAccountId}/archive |
In the vendors API response, we have introduced a new paymentNetworkId field. This field provides the vendor Payment Network ID (PNI). Each vendor with a BILL account is a unique PNI.
See POST /v3/vendors in the API reference for more information.
We have added a new Postman notebook for the bill approvals workflow with the BILL v3 API. See the Bill Approvals Workflow with the BILL v3 API Postman notebook for details.
In this notebook, you build an API workflow that enables you to set up a bill approval policy, get the list of bills pending approval, and approve a bill for payment.
In all, we now have 2 published Postman notebooks.
