You can now generate a developer key in the BILL web app to work with the BILL API. As an administrator of your test organization, you can generate up to 4 developer keys.

See Sandbox API sign up for more information.

Bug fixes

User verification widget

We learned that the user was able to submit the verification form without providing the complete address. We have now fixed this issue. We ensure that the address information is available and complete before the user can submit the verification form.

Vendor Search and Invite widget

We learned that the user was able to re-submit the vendor bank details form with keyboard navigation. We have now fixed this issue. Keyboard navigation for re-submitting the form has been disabled.

Manage funding widget

We have fixed minor styling issues on the payment methods and bank details screens.

Miscellaneous

We learned that banners added extra space at the bottom of all the widgets. We have now fixed this issue.

The webhook notification payloads for all bill-related events now include all the response fields for the bill. For example, if you have subscribed to the bill.updated event, the payload for each related notification will now include all the response fields for the each updated bill.

See Bill notification payloads for more information.

We have updated the webhooks events catalog to include the payment.failed event. When your Create a payment (with POST /v3/payments) or Create a bulk payment (with POST /v3/payments/bulk) request fails, BILL sends you a notification with information to identify your payment request and with error messages to help you debug.

You can now set up subscriptions to receive notifications for the new event.

See Payment notification payloads for more information.

BILL is introducing UUIDs in the Spend & Expense API. Each ID value that uniquely identifies an entity in Spend & Expense (such as a budget, transaction, or user) now follows the UUID4 format.

UUID v4 (or UUID4) is a randomly-generated 128-bit identifier and is highly secure. The introduction of UUIDs in the Spend & Expense API is another measure taken by BILL for further improving its security standards.

Spend & Expense webhook notifications

When BILL sends notifications for the spend.transactions.updated event, each ID in the notification payload is a UUID value. For example, uuid is the UUID of the transaction, and userUuid is the UUID of the user that created the transaction.

See Spend & Expense transaction notification payloads for more information.

❗️

IMPORTANT

While the spend.transactions.updated notification payload includes only uuid values and no id values, the Spend & Expense API responses continue to present both uuid and id values.

In the future, the Spend & Expenseid values will deprecated. We will share more information when we have a timeline for this deprecation.

GET operations

Let's use the example of budgets to understand the impact of introducing UUIDs on the Spend & Expense GET operations.

When you get details about a budget with GET /v3/spend/budgets/{budgetId}, you currently set the budget id in your API request. Moving forward, you can set the budget uuid as another method for getting details about a budget.

GET response fields

For each existing Spend & Expense API object, BILL has generated a uuid value for each id value. In the GET /v3/spend/budgets/{budgetId} response example, both the uuid and id values are available to uniquely identify the budget.

Similarly, for fields with an id suffix, we now have the same field with the uuid suffix to present the UUID value. For example, for the parentBudgetId field in the API response for a budget, we now have a additional parentBudgetUuid field to present the UUID of the parent budget.

{
    "id": "QnVkZ2V0OjUyOTg2MQ==",
    "uuid": "bgt_mur9ttm5tt0m97tjj287s744t4",   // NEW UUID VALUE
    "name": "Happy Music Supplies monthly spending budget",
    "retired": false,
    "startDate": "2025-12-15",
    "recurringInterval": "MONTHLY",
    "timezone": "US/Eastern",
    "autoAddUsers": false,
    "receiptRequired": true,
    "carryOver": false,
    "budgetGroup": false,
    "parentBudgetId": "{parent_budget_id}",
    "parentBudgetUuid": "{parent_budget_uuid}",   // NEW UUID VALUE
    "shareFunds": "SHARE_MANUALLY",
    "recurringLimit": 200.00,
    "limitlessOverspend": false,
    "currentPeriod": {
        "startDate": "2025-12-01",
        "endDate": "2026-01-01",
        "limit": 200.00,
        "overspendBuffer": 0.00,
        "assigned": 0.00,
        "spent": {
            "cleared": 0.00,
            "pending": 0.00,
            "total": 0.00
        }
    },
    "default": false
}

POST, PATCH, PUT, and DELETE operations

Currently, you cannot use UUID values in the Spend & Expense POST, PATCH, PUT or DELETE operations. This feature will be available in the future. We will share more information when this feature is available.

In the payments API response, we have introduced two new fields in the rppsDisbursement object.

In addition, we have introduced a new disbursementStatus field in the response to provide the payment disbursement status at each stage of the payment.

See POST /v3/payments in the API reference for more information.

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

Chart of accounts

Items

When you list bills (GET /v3/bills) and invoices (GET /v3/invoices), you can now filter and sort with additional fields.

Filtering bills and invoices

You can now filter bills and invoices with additional fields.

See Filterable fields for the complete list of fields you can filter with.

Sorting bills and invoices

You can now sort bills and invoices with the archived field. See Sortable fields for the complete list of fields you can sort with.

Features

User verification widget improvements

• When the partner triggers the user verification widget for a user that does not have an active, verified bank account, we now inform the user that they are not required to complete their identity verification.
• When Google Places fails to load for the address field, we enable the user to manually enter address information and continue. In this case, we now ensure that Google Places does not throw unhelpful validation errors to the user.

Onboarding widget improvements

• On the KYC/KYB screen, we have added a spinner to ensure that Google Places is available for the user when they are using the address field.
• When the user bank account is added manually, we have added a spinner on the end state screens to provide a cleaner experience. This improvement disables the ability to click multiple times while the partner integration listens to the BILL success events and navigates back to the partner experience.

Features in the next release

• Usability improvements in the Convert to ePay widget
• Miscellaneous performance improvements

Features

Manage funding widget improvements

• On the add payment method screen, we have added a spinner to provide a cleaner experience. When the user clicks Add to add a new payment method, they now see a smoother transition to the adding funding screen.
• On the bank account details screen, we no longer provide information about the default payment method. In addition, users can no longer set a bank account as the default payment method.
• We received feedback that when a user deletes an existing bank account, BILL provides an unhelpful status for the deleted bank account. We now provide the correct bank account status of Deleted.

User verification widget improvements

• At the end of the user verification flow, we have added a spinner to provide a cleaner experience. This improvement disables the ability to re-submit the verification form. In addition, we have added a spinner to ensure that Google Places is available for the user when they are using the address field.
• On the bank account details screen, we learned that the user verification banner would intermittently appear when the user is adding a new funding method. We have fixed this styling issue.

Onboarding widget improvements

When the user bank account is added with the Plaid flow, we have improved the transition from the onboarding widget to the user verification widget.

MFA widget improvements

On the 2-step verification screen, we have ensured that the radio buttons follow the chosen color theme.

Miscellaneous

We learned that the focus state on buttons is cut off on certain screens. We have now fixed this styling issue.

Features in the next release

• Usability improvements in the Onboarding, MFA, and Convert to ePay widgets
• Miscellaneous performance improvements