BILL

BILL

BILL (formerly Bill.com) runs accounts payable (vendors, bills, approvals, payments) and accounts receivable (customers, invoices, received payments) for US businesses. This connector uses the BILL v3 API, read-only by default.

Setup

1. BILL API access needs a developer key (devKey). An administrator generates it in the BILL web app: Settings → Sync & Integrations → Manage Developer Keys → Generate developer key (production), or in a sandbox developer account from the BILL developer portal sign-up (https://developer.bill.com).
2. BILL_USERNAME and BILL_PASSWORD: the e-mail and password of a BILL user of that organization. Use a dedicated API user; its role limits what the API can see and do.
3. BILL_ORGANIZATION_ID: shown at the bottom of the same Manage Developer Keys page; it starts with 008.
4. BILL_API_URL: https://gateway.prod.bill.com/connect for production, https://gateway.stage.bill.com/connect for the sandbox. A sandbox devKey does not work on production and the reverse.

The connector signs in with POST /v3/login and sends the returned sessionId and the devKey as headers on every call. A session expires after 35 minutes without activity; the connector signs in again by itself. The login limit is 200 per developer key per hour.

Start here

• bill_com_get_session checks the sign-in.
• Payables: bill_com_list_bills with filters=paymentStatus:in:"UNPAID,PARTIALLY_PAID" and sort=dueDate:asc; bill_com_list_pending_approvals for what waits for you.
• Receivables: bill_com_list_invoices with filters=status:in:"OPEN,PARTIAL_PAYMENT".

Filters, sort, pages

filters is field:operator:value, several separated by commas (AND). Operators: eq, ne, gt, gte, lt, lte, in, nin, sw (starts with). Quote values that contain commas or times: createdTime:gte:"2026-09-01T00:00:00.000Z", paymentStatus:in:"UNPAID,PARTIALLY_PAID". Not every field is filterable; common ones: vendors/customers name (eq, sw), archived, createdTime, updatedTime; bills vendorId, dueDate, paymentStatus; invoices customerId, status; payments vendorId, processDate, status; received payments customerId, paymentDate, status; vendor credits and credit memos creditDate, status (NOT_APPLIED, PARTIALLY_APPLIED, FULLY_APPLIED). sort is field:asc|desc; recurring bills sort only by archived, received payments by amount, createdTime or updatedTime. max up to 100 (default 20). For the next page pass page = the nextPage value from the answer, without filters and sort.

Ids

BILL ids have type prefixes: vendors 009, bills 00n, customers 0cu, invoices 00e, payments stp, organizations 008.

Limits

20,000 requests per developer key per hour and 3 concurrent requests per organization; errors BDC_1144 and BDC_1322 mean wait and retry.

Writes

Approving or denying bills is included but installed switched off. Payments, bill and invoice creation are not part of this connector.