Articles in this section

Set up a connection to Bill.com

Tanisha Ray
Updated

Bill.com is a leading cloud-based platform that automates and streamlines financial processes, including accounts payable, accounts receivable, and payments.

Set up a connection

After you start the connection, configure it in the Create connection panel and complete all of the required * authentication settings:

Setting

Instructions

Name your connection * 

Enter a clear and distinguishable name.

Throughout integrator.io imports and exports, you will have the option to choose this new connection. A unique identifier will prove helpful later when selecting it from a list of the connections in your account.

API type *

Choose your Bill.com account API type:

  • Accounts Payable (AP) and Accounts Receivable (AR) V2: Manage supplier bills, vendor payments, customer invoices, and receivables. Use it to run core payables/receivables workflows and sync billing data with your accounting system.

  • Accounts Payable (AP) and Accounts Receivable (AR) V3: Access newer AP/AR endpoints with expanded fields and stronger workflow coverage. Use it to build more flexible, modern accounting automations and richer integrations.

  • Partner operations: Manage partner onboarding, multi-entity access, and client administration. Use it for service providers/ISVs to operate and integrate Bill.com across multiple customers at scale.

  • Spend and expense: Capture, approve, and report employee spend and reimbursable expenses. Use it to streamline expense submission, policy controls, and finance reporting for teams.

Environment * 

Select your Bill.com account environment:

  • Production: if your account URL is https://api-stage.bill.com/api/v2

  • Sandbox: if your account URL is https://api-sandbox.bill.com/api/v2.

API type: Accounts Payable (AP) and Accounts Receivable (AR) V2 and V3

Organization ID * 

Enter your Bill.com organization ID provided by the Bill.com support team. For more information, see Authentication.

Username *

Enter your Bill.com developer account username.

Password * 

Enter your Bill.com developer account password.

Multiple layers of protection, including AES 256 encryption, are in place to keep your password safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

Developer key * 

Enter your Bill.com developer key provided by the Bill.com support team. For more information, see Authentication.

API type: Partner operations

Application key *

Enter your Bill.com application provided to you by Bill.com via email.

Username *

Enter your Bill.com developer account username.

Password * 

Enter your Bill.com developer account password.

Multiple layers of protection, including AES 256 encryption, are in place to keep your password safe. When editing this connection, you must re-enter this value each time; it is stored only when the connection is saved and never displayed as text.

API type: Spend and expense

API token*

Enter your Bill.com account API token.

Multiple layers of protection are in place, including AES 256 encryption, to keep your connection’s API token safe. When editing this form later, you must enter this token again; it is stored only when the connection is saved and never displayed as text.

dataLoad.svg​​How to retrieve the API token

Tip

This connector documentation describes only the settings shown for the Simple view. For the corresponding HTTP settings, see custom, universal connector documentation.

How to retrieve the API token

  1. Sign in to your bill.com Spend and expense account.

  2. Navigate to Profile icon > Profile > My account > Settings > API tokens.

  3. Click Generate new token.

  4. Enter a Name.

  5. Enter a Description.

  6. Click View in the New token field.

  7. Copy the API token.

Additional references