create_bill_payment
Pay one or more bills and optionally apply vendor credits to clear Accounts Payable. Records vendor payments for bank feed matching.
Instructions
Create a bill payment (the QBO 'check' / 'pay bills' flow). Pays one or more existing bills and optionally applies vendor credits, clearing Accounts Payable. Use this to record vendor ACH/EFT debits or checks so the bank feed can match them — especially when a bank charge equals bills minus credit memos. Amounts default to each bill's open balance and each credit's remaining balance. Returns payment details and a link to view in QuickBooks.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| vendor_name | No | Vendor display name (e.g., 'US Foods'). Will be looked up to get ID. | |
| vendor_id | No | Vendor ID (use if you already know it, otherwise use vendor_name) | |
| payment_account | Yes | Bank account name or number the payment is drawn from (e.g., 'PLAT BUS CHECKING', '5752'). Will be looked up to get ID. | |
| txn_date | Yes | Payment date in YYYY-MM-DD format (use the bank debit date for bank-feed matching) | |
| memo | No | Private memo for the payment | |
| doc_number | No | Reference number, e.g., check number or EFT reference (optional) | |
| bills | Yes | Bills to pay. Each bill must belong to the vendor and have an open balance. | |
| credits | No | Vendor credits to apply against the bills (optional). Each credit must belong to the vendor and have remaining balance. | |
| draft | No | If true, validate and show preview without creating (default: true) |