> For the complete documentation index, see [llms.txt](https://docs.kick.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kick.co/integrations/bill.com.md).

# BILL

Connecting BILL brings your bills, invoices, vendors, and payment data into Kick - so your AP and AR activity is reflected in your books without manual entry. Bills sync to the [Bill Pay](/common-workflows/bill-pay.md) tab; invoices sync to the [Invoicing](/common-workflows/invoicing.md) tab.

{% hint style="info" %}
You must be an **admin** of your BILL account to connect the integration.
{% endhint %}

***

### Connect BILL

**From the Accounts tab:**

1. Go to the **Accounts** tab
2. Click **Add account** and select **BILL**

**From the Bill Pay tab:**

1. Go to the **Bill Pay** tab
2. Click **Connect BILL**
3. Complete the token setup steps below

Both methods connect the full integration - bills, invoices, vendors, customers, and payments all sync regardless of where you connect.

#### Step 1: Start the connection in Kick

If you started from the **Bill Pay** tab, Kick opens the connection flow automatically. Otherwise:

1. Go to the **Accounts** tab
2. Click **Add account** and select **BILL**

#### Step 2: Create an API token in BILL

1. [Sign in to BILL](https://login.us.bill.com/neo/login)
2. In the left navigation, open **Settings**
3. Go to **Sync & Integrations → Tokens**
4. Click **Create token**, enter a token name (for example, `kick-bill-integration`), and save
5. Copy the **token value** (the secret string BILL shows once, like a password) to your clipboard before you leave the screen

{% hint style="warning" %}
Copy the token value to your clipboard before closing the screen - BILL only shows it once.
{% endhint %}

{% embed url="<https://player.mux.com/h2LpCNirnB7uBXrs01EgJQ6IOUfQmtL4hC37nIu6X5N8>" %}

#### Step 3: Complete the connection in Kick

1. Return to Kick
2. Enter the **token name** (you can use the same name you chose in BILL) and paste the **token value**
3. Click **Connect**

{% embed url="<https://player.mux.com/s00naRMkcK2k1sJ5RbenhKYL7BVpTEnd1oXd3vkE5sUk>" %}

***

### Map your accounts

To make sure bills and invoices are categorized to the right accounts automatically, upload your Kick Chart of Accounts to BILL.

**Export from Kick:**

1. Go to **Accounting** → **Chart of Accounts**
2. Click the download icon and select **Chart of Accounts (.csv)**

**Import to BILL:**

1. In BILL, open **Settings** in the left navigation, then go to **Import & export**
2. Click **Custom File Integration** in the sidebar
3. Scroll to **Accounts** and click **Import**
4. Upload the CSV from Kick

Your Kick accounts are now available when categorizing bills and invoices in BILL, and those assignments sync into Kick automatically.

***

### What syncs

* **Bills** - bills created in BILL, visible in Kick's [Bill Pay](/common-workflows/bill-pay.md) tab with AP aging and vendor details
* **Invoices** - invoices created in BILL, visible in Kick's [Invoicing](/common-workflows/invoicing.md) tab with customer details and payment status
* **Vendors and customers** - contact information syncs to [Counterparties](/common-workflows/counterparties.md)
* **Payments** - payment transactions and status updates
* **GL account assignments** - account categorizations for bills and invoices sync into Kick automatically

***

### Bills and invoices in Kick

Once BILL is connected, your bills appear in the **Bill Pay** tab and your invoices appear in the **Invoicing** tab. You can view bills by vendor, by bill, or by line item - and see which are upcoming, overdue, or paid.

→ [Bill Pay](/common-workflows/bill-pay.md)\
→ [Invoicing](/common-workflows/invoicing.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.kick.co/integrations/bill.com.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
