Get started in Production

The BILL API documentation website provides instructions for testing your integrations with the BILL v3 API in the sandbox environment. Follow this guide when you are ready to go live with your integration in the BILL production environment.

👍

You need new keys and tokens in production

This guide assumes that you have tested with the BILL v3 API in the sandbox environment before you have started your go-live operations in production.

Any sandbox key and token will not work in the production environment.

Production API base URLs

Update the base URLs in your integration for testing with the API in the production environment.

Generate production keys and tokens

The AP & AR developer key and related credentials are required for testing with AP & AR API endpoints. The Spend & Expense API token is required for testing with the Spend & Expense API. As a BILL app partner, you can generate an AP & AR sync token with the BILL web app.

AP & AR developer key and credentials

When you sign-up to create your BILL account, you set up four credentials required for the AP & AR API. These credentials are required for you to sign in with POST /v3/login.

Navigate to bill.com/signup and sign up to create your BILL account. In your sign-up form, select Accounts Payable & Receivable and continue with the sign-up flow.

When your sign-up is complete, your username and password is set. Sign in and generate your AP & AR developer key and continue testing with the API in production.

1. Sign in to the BILL web app. Use your email address and password.
2. Click Settings in your BILL account.
3. Click Sync & Integrations > Manage Developer Keys.
4. Click Generate developer key. You are prompted to agree to the BILL developer terms of service.
5. Review and accept the terms of service, and then click Generate key. It takes up to a minute for BILL to generate a developer key. Click Reload page in a few moments to view your generated key.

Keep your key in a safe place, such as a password manager.

👍

Your organization ID is at the bottom of this page

The organization ID for your BILL account is available at the bottom of this page. This organization ID is required for you to sign in with POST /v3/login.

Spend & Expense API token

Generate a Spend & Expense API token for Spend & Expense API operations. See Apply for BILL Spend & Expense in the BILL Help Center for instructions on setting up your Spend & Expense application.

See Generate an API token in BILL Spend & Expense in the BILL Help for instructions on getting a Spend & Expense API token in the production environment. Set the generated API token as the required apiToken header value in all your Spend & Expense API requests.

BILL app partner AP & AR token

As a BILL app partner, you can generate an AP & AR sync token with the BILL web app.

1. Sign in to the BILL web app. Use your email address and password.
2. Click Settings in your BILL account.
3. Click Sync & Integrations > Tokens.
4. Click NEW to create a new sync token.
5. Enter a NAME and click SAVE. The name is your username for signing in with POST /v3/login.

A new sync token is generated. This sync token is your password for signing in with POST /v3/login.

Bank accounts in Production

After your sign up is complete, you can add a bank account using the BILL web app.

• See Add a bank account in the BILL Help Center to learn about adding a bank account for AP & AR operations.
• See Add company bank account in BILL Spend & Expense to learn about adding a bank account for Spend & Expense operations.

Pricing in Production

You will be charged the usual price plan fee after the 30-day trial in the production environment. See BILL pricing for more information about price plans.