# Bill.com

{% hint style="info" %}
**Before you connect**

You must be an **admin** of your Bill.com account to connect the integration.
{% endhint %}

### **Connecting Bill.com**

#### **Step 1: Initiate connection in Kick**

1. Go to the **Accounts** tab
2. Click **Connect account**
3. Select **Bill.com**

<figure><img src="/files/II3i0oGh9fuSWjDOI1Jj" alt=""><figcaption></figcaption></figure>

#### **Step 2: Create an API token in Bill.com**

You'll need to create a sync token in your Bill.com account:

1. Sign in to your Bill.com account
2. Click the gear icon (Settings) in the top right
3. Go to **Sync & Integrations > Tokens**
4. Click **New** to create a sync token
5. Enter a name (e.g., "Kick Integration") and click **Save**
6. Copy both the **token name** and **token value** — you'll need both in the next step

{% hint style="warning" %}
Don't close the token screen before you save the token value in a safe place - Bill.com only shows it once.
{% endhint %}

{% embed url="<https://www.loom.com/share/f5f0056738124d8c9ab45275b9d2e2ce>" %}

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

1. Return to Kick
2. Paste the **token name** and **token value**
3. Click **Connect**

{% embed url="<https://www.loom.com/share/fd750c5a46d249b88b7d405056dbd770>" %}

***

### **Chart of Accounts mapping**

To categorize bills and invoices to the correct GL account without further work, upload your Kick Chart of Accounts to Bill.com.

#### **Export from Kick**

1. In Kick, go to **Accounting > Chart of Accounts**
2. Click the download icon in the top right
3. Select **Chart of Accounts (.csv)**
4. Save the file

<figure><img src="/files/c1mOzRsc9E2bZMTD2t6Q" alt=""><figcaption></figcaption></figure>

#### **Import to Bill.com** <a href="#import-to-bill.com" id="import-to-bill.com"></a>

1. In Bill.com, go to **Settings > Import & export**
2. Click **Custom File Integration** in the left sidebar
3. Scroll to **Accounts** and click **Import**
4. Upload the CSV file from Kick
5. Map fields if prompted and complete the import

Your Kick GL accounts are now available when categorizing bills and invoices in Bill.com.

{% embed url="<https://www.loom.com/share/0a41b7db852044b9bf4abcb1e19d4c83>" %}

***

### **What syncs from Bill.com**

Once connected, the following data syncs automatically:

* **Bills** — All bills created in Bill.com
* **Invoices** — All invoices created in Bill.com
* **Vendors** — Vendor information and contact details
* **Customers** — Customer information and contact details
* **Payments** — Payment transactions and status updates
* **GL account assignments** — Account categorizations for bills and invoices

***

### **Viewing Bill.com data in Kick**

View your synced data in the **Bill Pay** tab. Read more about [Bill Pay](https://accountants.kick.co/bookkeeping-workflows/bill-pay).

***

## **FAQ**

<details>

<summary><strong>What to do if my connection failed?</strong></summary>

* Verify you created a sync token in **Bill.com Settings > Sync & Integrations > Tokens**
* Ensure you copied both token name and token value
* Check for extra spaces when pasting

</details>

<details>

<summary><strong>Why my bills are not syncing in Kick?</strong></summary>

* Confirm bills are saved in Bill.com
* Check last sync time in Kick **Accounts** tab
* Refresh the **Bill Pay** tab

</details>

<details>

<summary><strong>Why some GL accounts are missing in Bill.com?</strong></summary>

* Confirm you imported Chart of Accounts (see Chart of Accounts mapping above)
* If you updated your Chart of Accounts in Kick, you will have to manually [update your accounts in Bill.com](https://docs.kick.co/setting-up/integrations/pages/ZJzKGPk9KawrF75TKykb#import-to-bill.com)
* Check import status: **Bill.com Settings > Import & export > History**

</details>


---

# Agent Instructions: 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:

```
GET https://docs.kick.co/setting-up/integrations/bill.com.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.