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

# Connect BILL to Rillet

Connect BILL to Rillet to synchronize accounts payable activity between both systems.\
This integration helps keep vendors, bills, payments, and supporting documents aligned so your financial data stays up to date in Rillet.

You can use the integration to:

* Sync vendors and bills from BILL into Rillet.
* Sync AP payment activity into Rillet.
* Maintain supporting documentation across systems.
* Review payment and bill activity directly from the general ledger.

### Before You Begin

Before setting up the integration, make sure you have:

* Admin access in Rillet.
* Admin access in BILL.
* Access to Organization Settings in Rillet.

Each BILL connection requires its own API key and webhook configuration.

### Generate an API Key in Rillet

The BILL integration requires a Rillet API key to authenticate and synchronize data between both systems.

To create an API key:

1. Select **Organization Settings**.

   <figure><img src="/files/RbnhFeyhBO1jL286Fz6Z" alt=""><figcaption></figcaption></figure>
2. Select **API Access**.
3. Click **+ Create API Key**.

   <figure><img src="/files/2M7Cie7O35eTgbNCazl8" alt=""><figcaption></figcaption></figure>
4. Enter an **API Key Name** to help identify the key later.

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>Important</strong><br>Do not enable the <strong>Read-only</strong> option. The BILL integration requires write access to sync data correctly.</p></div>
5. Click + **Create API Key**.

   <figure><img src="/files/jsHEPmaFYTonPWhDoto5" alt=""><figcaption></figcaption></figure>
6. Copy the API key and store it securely.

   <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p><strong>Important</strong> <br>The full API key is only displayed once for security reasons. After closing the window, you will not be able to view the key again.</p></div>

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

You will need this API key when configuring the integration in BILL.

{% hint style="danger" %}
Never share your API key outside your organization.
{% endhint %}

### Create a Webhook in Rillet

After creating the API key, configure a webhook for the BILL integration.

To create the webhook:

1. Select **Webhooks** from the side panel.
2. Click **+ Create Webhook**.<br>

   <figure><img src="/files/Bob5KvFIdelhUKmxQ7SI" alt=""><figcaption></figcaption></figure>
3. Enter a name for the webhook.
4. Enter the webhook URL provided by BILL.
5. Add the following entities:
   * **Bill**
   * **Vendor**
6. For both entities, select only the **Deleted** event.
7. Click **Create**.

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

After the webhook is created:

8. Select the webhook to open the details.
9. Copy the **Signing Token**.

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

You will use both the API key and signing token when completing the setup in BILL.

### Configure the BILL Connection

Complete the integration setup from BILL using the credentials generated in Rillet.

To connect BILL and Rillet:

1. In BILL, go to **Settings** from the sidebar.
2. Select **Sync & Integration > App Center**.
3. Locate **Rillet** and click **Connect**.
4. Enter the following credentials from Rillet:
   * API Key
   * Webhook Signing Token
5. Click **Next**.
6. (Optional) Select the Rillet subsidiary to connect with the BILL organization.

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Note</strong><br>Each BILL organization connects to a single Rillet subsidiary.</p></div>
7. Click **Connect**.
8. Click **Sync** in the upper-right corner.
9. Select **View Details**.

### Configure Sync Preferences in BILL

After connecting the integration, configure how accounting data syncs between BILL and Rillet.

To configure sync preferences:

1. Go to **Settings**.
2. Select **Sync & Integration > Preferences**.
3. Select the default bank account GL.
4. Select **Classifications** to review the Rillet fields synced into BILL.
5. In the custom dimensions section, select **View**.
6. Enable the Rillet fields you want to display on the AP Bill page.

### Create and Sync an AP Bill

After the integration is configured, you can create AP bills in BILL and sync them into Rillet.

To create and sync a bill:

1. In BILL, go to **Bills**.
2. Select **Unpaid Bills**.
3. Click **Enter Bill**.
4. Select the vendor and complete the bill details.
5. Set the required custom dimensions (Rillet fields).
6. Click **Create Bill**.
7. Click **Sync**.
8. Select **Sync Now**.

The AP bill syncs automatically into Rillet.

### Sync Payments to Rillet

You can also sync AP payment activity from BILL into Rillet.

To sync a payment:

1. Open the bill in BILL.
2. Select **Review & Pay**.
3. Complete the payment process.
4. Click **Done**.
5. Click **Sync**.
6. Select **Sync Now**.

The payment syncs automatically into Rillet.

### Review Synced Activity in Rillet

After synchronization completes, you can review synced bills and payment activity directly in Rillet.

To review synced activity:

1. Go to **Accounts Payable > Bills** in Rillet.
2. Review the **Bill Number** column and confirm the bill synced from BILL.
3. Open the synced bill.
4. Review the **History** section to confirm the payment synced successfully.
5. Click the **three-dot** menu (...).
6. Select **GL Impact.**

This view allows you to review the general ledger impact of both the AP bill and the related payment.

### See Also

For related topics, see:

* [**API Access**](/EjmEP4KZ9BVp9j2ho4Mh/settings-and-config/api-access.md)
* [**Add a Bill**](/EjmEP4KZ9BVp9j2ho4Mh/accounts-payable/expense-transactions/add-a-bill.md)
* [**Pay a Bill**](/EjmEP4KZ9BVp9j2ho4Mh/accounts-payable/expense-transactions/pay-a-bill.md)
* [**Vendor Credits**](/EjmEP4KZ9BVp9j2ho4Mh/accounts-payable/vendors/vendor-credits.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.rillet.com/EjmEP4KZ9BVp9j2ho4Mh/integrations/expense-management/connect-bill-to-rillet.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.