How do I connect Bill.com so vendor bills import into Luminous?

Last updated: November 11, 2026

Overview

The Bill.com connection brings your vendor bills into Luminous so they can be matched to purchase orders and receipts (three-way match). It is inbound only. You keep approving and paying bills in Bill.com. Luminous does not push payments or prepayment requests to Bill.com.

This lives under Settings > Bill Pay. It is rolling out behind a feature flag. If you don't see Bill Pay, ask your Luminous contact to enable it.

Before you start

In Bill.com, an administrator needs to have:

  • A sync token. Go to Settings > Sync & Integrations > Tokens, create one, and note both its name and its value.

  • Your Organization ID. It's in Settings > Sync & Integrations > Manage Developer Keys, at the bottom of the page. It starts with 008.

  • Possibly a developer key. See the note in step 3.

Connect

  1. Go to Settings → Bill Pay and click Add connection.

  2. Under Provider, choose Bill.com, then give the connection a Label.

  3. Enter the Sync token name, Sync token and Organization ID.

  4. If a Developer key field appears, enter it (Bill.com: Settings → Sync & Integrations → Manage Developer Keys → Generate developer key). If the field doesn’t appear, Luminous uses its own key.

  5. Click Save & test. Luminous signs in and reads a vendor to confirm the details work.

The Bill.com environment (live or sandbox) is set by Luminous, not on the form.

What happens next

  • Luminous checks Bill.com regularly. It has no live notifications from Bill.com, so a new bill arrives at the next check. Open bills come in first, then paid ones, so a bill that was already paid when Luminous first saw it still arrives.

  • Draft bills are skipped.

  • Each bill is matched to a PO using the PO number found on the bill, and its attached documents are brought in. The Bills tab's "How this works" box shows where Luminous looks.

  • Link your Bill.com vendors to Luminous suppliers. Vendor linking works as it does for other bill-pay connections. A bill whose vendor isn't linked, or that looks like a duplicate, is held in Exceptions until you resolve it.

  • Every bill that comes in is listed in Activity.

Related

For how bills reconcile against receipts once they're in Luminous, see "Do bills automatically reconcile against receipts when created, and how does bill reconciliation work?". The Ramp connection works the same way for bill intake. See "How does the Ramp bill-pay integration work".