Skip to main content

Bill Component

Use the Bill component to manage Bank Accounts, Invoices, Bills, and more.

Component key: bill ·
· Changelog ↓

Description​

Bill.com is a leading provider of cloud-based software that simplifies and automates back-office financial operations for small and midsize businesses.

Use the Bill component to manage Bank Accounts, Invoices, Bills, and more.

API Documentation​

This component was built using the Bill API Reference

Connections​

Client Credentials​

key: billConnection

Prerequisites​

The following credentials are needed to authenticate with the BILL API:

  • Username: The username is the email address used to sign in to the API sandbox developer account.
  • Password: The password is used to sign in to the API sandbox developer account.
  • Organization ID: The API sandbox developer account represents the organization in BILL. The organization ID is a unique alphanumeric value that begins with 008.
  • Developer key: The developer key is used to uniquely identify the developer account in API requests.

Setup Steps​

  1. Retrieve Credentials The BILL team must provide an email containing the API login information: username, password, organization ID, and developer key.

Configure the Connection​

  1. Open the configuration settings for the Bill connection and input the credentials:
    • Username: Enter the email address used to sign in to the API sandbox developer account.
    • Password: Enter the password used to sign in to the API sandbox developer account.
    • Organization ID: Enter the organization ID (unique alphanumeric value beginning with 008).
    • Developer Key: Enter the developer key used to uniquely identify the developer account in API requests.
    • Use Production URL: Turn this On to use the production URL. Turn this Off to use the sandbox URL.
InputNotesExample
Developer Key

The developer key is used to uniquely identify the developer account in API requests.

Organization ID

The organization ID is a unique alphanumeric value that begins with 008.

Password

The password is used to sign in to the API sandbox developer account.

Use Production URL

Turn this On to use the production URL. Turn this Off to use the sandbox URL.

true
Username

The username is the email address used to sign in to the API sandbox developer account.

Triggers​

New and Updated Records​

Checks for new and updated records in a selected Bill.com resource type on a configured schedule. | key: pollChangesTrigger

InputNotesExample
Connection

The Bill.com connection to use.

Resource Type

The type of resource to poll for changes.

Show New Records

When true, newly created records will be included in the trigger output.

true
Show Updated Records

When true, records that were updated after the last poll will be included in the trigger output.

true

This trigger polls the Bill.com API for new and updated records of the selected resource type on a configured schedule.

How It Works​

  1. The trigger runs on the configured schedule (e.g., every 5 minutes)
  2. On each execution, the trigger sends a request to the Bill.com List endpoint corresponding to the selected resource type, applying a server-side filter of updatedTime > lastPolledAt to retrieve only records changed since the last successful poll
  3. Results are paginated automatically until all matching records have been retrieved
  4. Records are categorized client-side as created or updated by comparing each record's createdTime and updatedTime against the timestamp of the last successful poll. Newly created records have createdTime newer than the last poll; existing records with updatedTime newer than the last poll are classified as updated
  5. The trigger updates its internal state with the current timestamp after each poll so subsequent executions only surface records changed since the previous run
  6. When no records match on a given run, the trigger reports polledNoChanges so downstream flows are not invoked unnecessarily
  7. If both Show New Records and Show Updated Records are disabled, the trigger short-circuits without calling the API and returns empty arrays

Supported Resource Types​

The trigger supports the following Bill.com resources:

ResourceList EndpointChange Detection
Bills/List/Bill.jsonTimestamp (createdTime, updatedTime)
Customers/List/Customer.jsonTimestamp (createdTime, updatedTime)
Invoices/List/Invoice.jsonTimestamp (createdTime, updatedTime)
Vendors/List/Vendor.jsonTimestamp (createdTime, updatedTime)

Configuration​

Configure the following inputs:

  • Connection: The Bill.com connection used to authenticate API requests
  • Resource Type: The type of resource to poll for changes — Bills, Customers, Invoices, or Vendors
  • Show New Records: When enabled, newly created records are included in the trigger output. Defaults to true
  • Show Updated Records: When enabled, records that were updated after the last poll are included in the trigger output. Defaults to true

Returned Data​

The trigger returns an object containing two arrays — created for newly created records and updated for modified records. Each array contains full Bill.com resource objects matching the selected resource type.

Example Response
{
  "data": {
    "created": [
      {
        "id": "00n01ABCDEFGHIJKL",
        "createdTime": "2024-08-21T12:00:00.000+0000",
        "updatedTime": "2024-08-21T12:00:00.000+0000",
        "vendorId": "00v01MNOPQRSTUVWX",
        "invoiceNumber": "INV-1001",
        "amount": 250.0,
        "dueDate": "2024-09-20"
      }
    ],
    "updated": [
      {
        "id": "00n01YZABCDEFGHIJ",
        "createdTime": "2024-08-10T09:00:00.000+0000",
        "updatedTime": "2024-08-21T14:22:00.000+0000",
        "vendorId": "00v01KLMNOPQRSTUV",
        "invoiceNumber": "INV-0987",
        "amount": 1200.0,
        "dueDate": "2024-09-10"
      }
    ]
  }
}

Notes​

  • On the very first execution, the trigger has no prior poll timestamp and uses the current time as its baseline, so no historical records are emitted on the initial run — only changes that occur after the trigger is enabled will be surfaced
  • The Bill.com List API combines multiple filters with AND and does not support OR, so a single filter on updatedTime is used. This captures both newly created records (whose updatedTime equals their createdTime) and records that were modified after the last poll
  • Refer to the Bill.com API documentation for rate limit details and the full set of fields available on each resource type

Data Sources​

Select Bill​

Select a bill from the list of available bills. | key: selectBill | type: picklist

InputNotesExample
Connection

The Bill.com connection to use.

Select Customer​

Select a customer from the list of available customers. | key: selectCustomer | type: picklist

InputNotesExample
Connection

The Bill.com connection to use.

Select Customer Bank Account​

Select a customer bank account from the list of available customer bank accounts. | key: selectCustomerBankAccount | type: picklist

InputNotesExample
Connection

The Bill.com connection to use.

Select Invoice​

Select an invoice from the list of available invoices. | key: selectInvoice | type: picklist

InputNotesExample
Connection

The Bill.com connection to use.

Select Vendor​

Select a vendor from the list of available vendors. | key: selectVendor | type: picklist

InputNotesExample
Connection

The Bill.com connection to use.

Select Vendor Bank Account​

Select a vendor bank account from the list of available vendor bank accounts. | key: selectVendorBankAccount | type: picklist

InputNotesExample
Connection

The Bill.com connection to use.

Actions​

Authenticate MFA Session​

Use this action to authenticate an MFA session. Session only last 30 days. | key: mfaAuthenticate

InputNotesExample
Challenge ID

The challenge ID received from the 'Generate an MFA challenge ID' action.

!b-KXe8pBDp1vFgjczl...
Connection

The Bill.com connection to use.

Session ID

The session ID received from the 'Generate an MFA challenge ID' action.

Code Token

The MFA code token received at the user's device.

987123
Example Payload for Authenticate MFA Session⤓
Loading…

Bulk Create Bills​

Bulk create bill objects. | key: bulkCreateBills

InputNotesExample
Bills to Create

An array of bill objects to create. See Bill.com API documentation for more information.

[
  {
    "obj": {
      "entity": "Bill",
      "isActive": "string",
      "vendorId": "string",
      "invoiceNumber": "string",
      "invoiceDate": "string",
      "dueDate": "string",
      "glPostingDate": "string",
      "exchangeRate": 0,
      "description": "string",
      "poNumber": "string",
      "payFromBankAccountId": "string",
      "payFromChartOfAccountId": "string",
      "paymentTermId": "string",
      "hasAutoPay": true,
      "eBillCreated": true,
      "invoiceProductId": "string",
      "chartOfAccountId": "string",
      "departmentId": "string",
      "locationId": "string",
      "actgClassId": "string",
      "source": "string",
      "useBillDesc": true,
      "defaultInvoiceNumber": true,
      "isAutoSaved": true,
      "billTemplateId": "string",
      "billLineItems": [
        {
          "entity": "BillLineItem",
          "amount": 0,
          "chartOfAccountId": "string",
          "departmentId": "string",
          "locationId": "string",
          "jobId": "string",
          "customerId": "string",
          "jobBillable": true,
          "description": "string",
          "lineType": "string",
          "itemId": "string",
          "quantity": 0,
          "unitPrice": 0,
          "employeeId": "string",
          "actgClassId": "string",
          "purchaseOrderBillLinkId": "string",
          "unitOfMeasureId": "string",
          "lineOrder": 0,
          "cdFieldId1": "string",
          "cdFieldId2": "string",
          "cdFieldId3": "string",
          "cdFieldId4": "string",
          "cdFieldId5": "string",
          "cdFieldId6": "string",
          "useSmartApprovers": true
        }
      ]
    },
    "allowDuplicateInvNum": true
  }
]
Connection

The Bill.com connection to use.

Example Payload for Bulk Create Bills⤓
Loading…

Bulk Create Customers​

Bulk create customer objects. | key: bulkCreateCustomers

InputNotesExample
Connection

The Bill.com connection to use.

Customers to Create

An array of customer objects to create. See Bill.com API documentation for more information.

[
  {
    "obj": {
      "entity": "Customer",
      "isActive": "1",
      "name": "John",
      "companyName": "A Company",
      "contactFirstName": "John",
      "contactLastName": "Doe"
    }
  }
]
Example Payload for Bulk Create Customers⤓
Loading…

Bulk Create Invoices​

Bulk create invoice objects. | key: bulkCreateInvoices

InputNotesExample
Connection

The Bill.com connection to use.

Invoices to Create

An array of invoice objects to create. See Bill.com API documentation for more information.

[
  {
    "obj": {
      "entity": "Invoice",
      "isActive": "1",
      "customerId": "0cu...",
      "invoiceNumber": "10",
      "invoiceDate": "2024-04-10",
      "dueDate": "2024-04-20",
      "isToBePrinted": true,
      "invoiceLineItems": [
        {
          "entity": "InvoiceLineItem",
          "quantity": 1,
          "itemId": "0ii...",
          "price": 100
        }
      ]
    }
  }
]
Example Payload for Bulk Create Invoices⤓
Loading…

Bulk Create Vendor​

Bulk create vendor objects. | key: bulkCreateVendor

InputNotesExample
Connection

The Bill.com connection to use.

Vendors to Create

An array of vendor objects to create. See Bill.com API documentation for more information.

[
  {
    "obj": {
      "entity": "Vendor",
      "isActive": "string",
      "name": "string",
      "shortName": "string",
      "nameOnCheck": "string",
      "companyName": "string",
      "accNumber": "string",
      "taxId": "string",
      "taxIdType": "string",
      "track1099": true,
      "address1": "string",
      "address2": "string",
      "address3": "string",
      "address4": "string",
      "addressCity": "string",
      "addressState": "string",
      "addressZip": "string",
      "addressCountry": "string",
      "email": "string",
      "fax": "string",
      "phone": "string",
      "paymentEmail": "string",
      "paymentPhone": "string",
      "description": "string",
      "contactFirstName": "string",
      "contactLastName": "string",
      "accountType": "string",
      "paymentTermId": "string",
      "sendNotifications": true,
      "externalBillPayIn12m": 0,
      "since": 0,
      "payDaysBefore": 0,
      "enabledCombinePayments": true,
      "billCurrency": "string",
      "billSyncPref": "string",
      "prefPmtMethod": "string",
      "paymentPurpose": "string",
      "bankCountry": "string",
      "sendInviteForPrivateVendor": true,
      "vendorVCardRemitEmail": "string",
      "vendorVCardStatus": "string",
      "orgVCardStatus": "string",
      "prefRemitEmail": "string",
      "remitEmail": "string",
      "processorVCardStatus": "string",
      "vStatusUpdateSource": "string",
      "orgVCardOptOutCustReason": "string",
      "enableFundedInvite": true,
      "lastPaymentDate": "string",
      "numberOfInvitesSent": 0,
      "eligibleForEbills": true,
      "acknowledgedEbillBanner": true,
      "acknowledgedEbillError": true,
      "eBillEnablementFailed": true,
      "PaymentusMerchantId": "string",
      "unmodifiedBillsCount": "string",
      "setupAutoPayPrompt": true,
      "autoSave": "string",
      "creationSource": "string",
      "PaymentusPmtType": "string",
      "PaymentusAcctToken": "string",
      "PaymentusAcctToken2": "string",
      "PaymentusAcctToken3": "string",
      "stpProcessor": "string",
      "eBillEnabledStatus": "string"
    }
  }
]
Example Payload for Bulk Create Vendor⤓
Loading…

Bulk Create Vendor Bank Accounts​

Bulk create vendor bank account objects. | key: bulkCreateVendorBankAccounts

InputNotesExample
Connection

The Bill.com connection to use.

Device ID

The unique identifier for the device. Retrieved from the 'Authenticate MFA session' action.

Acme-...
MFA ID

The unique identifier for the MFA session. Retrieved from the 'Authenticate MFA session' action.

!b_EJCd_jPIsZYT...
Vendor Bank Accounts to Create

An array of vendor bank account objects to create. See Bill.com API documentation for more information.

[
  {
    "obj": {
      "entity": "VendorBankAccount",
      "isActive": "string",
      "vendorId": "string",
      "nameOnAcct": "string",
      "accountNumber": "string",
      "routingNumber": "string",
      "usersId": "string",
      "isSavings": true,
      "isPersonalAcct": true,
      "intlPaymentType": "string",
      "paymentCurrency": "string",
      "vendorBankData": "string",
      "bankAddSource": "string",
      "intlTemplateKey": "string",
      "regulatory1": "string",
      "regulatory2": "string",
      "regulatory3": "string",
      "regulatory4": "string",
      "regulatory5": "string",
      "regulatory6": "string",
      "regulatory7": "string"
    }
  }
]
Example Payload for Bulk Create Vendor Bank Accounts⤓
Loading…

Bulk Update Bills​

Bulk update bill objects. | key: bulkUpdateBills

InputNotesExample
Bills to Update

An array of bill objects to update. See Bill.com API documentation for more information.

[
  {
    "obj": {
      "id": "00n...",
      "entity": "Bill",
      "isActive": "string",
      "vendorId": "string",
      "invoiceNumber": "string",
      "invoiceDate": "string",
      "dueDate": "string",
      "glPostingDate": "string",
      "exchangeRate": 0,
      "description": "string",
      "poNumber": "string",
      "payFromBankAccountId": "string",
      "payFromChartOfAccountId": "string",
      "paymentTermId": "string",
      "hasAutoPay": true,
      "eBillCreated": true,
      "invoiceProductId": "string",
      "chartOfAccountId": "string",
      "departmentId": "string",
      "locationId": "string",
      "actgClassId": "string",
      "source": "string",
      "useBillDesc": true,
      "defaultInvoiceNumber": true,
      "isAutoSaved": true,
      "billTemplateId": "string",
      "billLineItems": [
        {
          "entity": "BillLineItem",
          "amount": 0,
          "chartOfAccountId": "string",
          "departmentId": "string",
          "locationId": "string",
          "jobId": "string",
          "customerId": "string",
          "jobBillable": true,
          "description": "string",
          "lineType": "string",
          "itemId": "string",
          "quantity": 0,
          "unitPrice": 0,
          "employeeId": "string",
          "actgClassId": "string",
          "purchaseOrderBillLinkId": "string",
          "unitOfMeasureId": "string",
          "lineOrder": 0,
          "cdFieldId1": "string",
          "cdFieldId2": "string",
          "cdFieldId3": "string",
          "cdFieldId4": "string",
          "cdFieldId5": "string",
          "cdFieldId6": "string",
          "useSmartApprovers": true
        }
      ]
    },
    "allowDuplicateInvNum": true
  }
]
Connection

The Bill.com connection to use.

Example Payload for Bulk Update Bills⤓
Loading…

Bulk Update Customers​

Bulk update customer objects. | key: bulkUpdateCustomers

InputNotesExample
Connection

The Bill.com connection to use.

Customers to Update

An array of customer objects to update. See Bill.com API documentation for more information.

[
  {
    "obj": {
      "id": "0cu...",
      "entity": "Customer",
      "isActive": "1",
      "name": "John",
      "companyName": "A Company",
      "contactFirstName": "John",
      "contactLastName": "Doe"
    }
  }
]
Example Payload for Bulk Update Customers⤓
Loading…

Bulk Update Invoices​

Bulk update invoice objects. | key: bulkUpdateInvoices

InputNotesExample
Connection

The Bill.com connection to use.

Invoices to Update

An array of invoice objects to update. See Bill.com API documentation for more information.

[
  {
    "obj": {
      "entity": "Invoice",
      "id": "00e",
      "isActive": "1",
      "customerId": "0cu...",
      "invoiceNumber": "10",
      "invoiceDate": "2024-04-10",
      "dueDate": "2024-04-20",
      "isToBePrinted": true,
      "invoiceLineItems": [
        {
          "entity": "InvoiceLineItem",
          "quantity": 1,
          "itemId": "0ii...",
          "price": 100
        }
      ]
    }
  }
]
Example Payload for Bulk Update Invoices⤓
Loading…

Bulk Update Vendors​

Bulk update vendor objects. | key: bulkUpdateVendors

InputNotesExample
Connection

The Bill.com connection to use.

Vendors to Update

An array of vendor objects to update. See Bill.com API documentation for more information.

[
  {
    "obj": {
      "id": "009...",
      "entity": "Vendor",
      "isActive": "string",
      "name": "string",
      "shortName": "string",
      "nameOnCheck": "string",
      "companyName": "string",
      "accNumber": "string",
      "taxId": "string",
      "taxIdType": "string",
      "track1099": true,
      "address1": "string",
      "address2": "string",
      "address3": "string",
      "address4": "string",
      "addressCity": "string",
      "addressState": "string",
      "addressZip": "string",
      "addressCountry": "string",
      "email": "string",
      "fax": "string",
      "phone": "string",
      "paymentEmail": "string",
      "paymentPhone": "string",
      "description": "string",
      "contactFirstName": "string",
      "contactLastName": "string",
      "accountType": "string",
      "paymentTermId": "string",
      "sendNotifications": true,
      "externalBillPayIn12m": 0,
      "since": 0,
      "payDaysBefore": 0,
      "enabledCombinePayments": true,
      "billCurrency": "string",
      "billSyncPref": "string",
      "prefPmtMethod": "string",
      "paymentPurpose": "string",
      "bankCountry": "string",
      "sendInviteForPrivateVendor": true,
      "vendorVCardRemitEmail": "string",
      "vendorVCardStatus": "string",
      "orgVCardStatus": "string",
      "prefRemitEmail": "string",
      "remitEmail": "string",
      "processorVCardStatus": "string",
      "vStatusUpdateSource": "string",
      "orgVCardOptOutCustReason": "string",
      "enableFundedInvite": true,
      "lastPaymentDate": "string",
      "numberOfInvitesSent": 0,
      "eligibleForEbills": true,
      "acknowledgedEbillBanner": true,
      "acknowledgedEbillError": true,
      "eBillEnablementFailed": true,
      "PaymentusMerchantId": "string",
      "unmodifiedBillsCount": "string",
      "setupAutoPayPrompt": true,
      "autoSave": "string",
      "creationSource": "string",
      "PaymentusPmtType": "string",
      "PaymentusAcctToken": "string",
      "PaymentusAcctToken2": "string",
      "PaymentusAcctToken3": "string",
      "stpProcessor": "string",
      "eBillEnabledStatus": "string"
    }
  }
]
Example Payload for Bulk Update Vendors⤓
Loading…

Create Bill​

Create a bill object. | key: createBill

InputNotesExample
Additional Fields

Additional fields that might not be covered by the standard inputs. See https://developer.bill.com/reference/createbill for more information.

{
  "entity": "Bill",
  "isActive": "string",
  "glPostingDate": "string",
  "exchangeRate": 0,
  "description": "string",
  "poNumber": "string",
  "payFromBankAccountId": "string",
  "payFromChartOfAccountId": "string",
  "paymentTermId": "string",
  "hasAutoPay": true,
  "eBillCreated": true,
  "invoiceProductId": "string",
  "chartOfAccountId": "string",
  "departmentId": "string",
  "locationId": "string",
  "actgClassId": "string",
  "source": "string",
  "useBillDesc": true,
  "defaultInvoiceNumber": true,
  "isAutoSaved": true,
  "billTemplateId": "string"
}
Allow Duplicate Invoice Number

When true, allows duplicate invoice numbers.

false
Bill Line Items

An array of bill line items. See Bill.com API documentation for more information.

[
  {
    "entity": "BillLineItem",
    "amount": 0,
    "chartOfAccountId": "string",
    "departmentId": "string",
    "locationId": "string",
    "jobId": "string",
    "customerId": "string",
    "jobBillable": true,
    "description": "string",
    "lineType": "string",
    "itemId": "string",
    "quantity": 0,
    "unitPrice": 0,
    "employeeId": "string",
    "actgClassId": "string",
    "purchaseOrderBillLinkId": "string",
    "unitOfMeasureId": "string",
    "lineOrder": 0,
    "cdFieldId1": "string",
    "cdFieldId2": "string",
    "cdFieldId3": "string",
    "cdFieldId4": "string",
    "cdFieldId5": "string",
    "cdFieldId6": "string",
    "useSmartApprovers": true
  }
]
Connection

The Bill.com connection to use.

Due Date

Date when the bill is due. The value is in the YYYY-MM-DD format.

2021-01-01
Invoice Date

Date when the bill is sent. This value is in the YYYY-MM-DD format.

2021-01-01
Invoice Number

User-generated invoice number. This value can be your chosen number scheme or bill due date.

01
Vendor ID

The unique identifier for the vendor.

009...
Example Payload for Create Bill⤓
Loading…

Create Customer​

Create a customer object. | key: createCustomer

InputNotesExample
Additional Fields

Additional fields that might not be covered by the standard inputs. See https://developer.bill.com/reference/createcustomer for more information.

{
  "isActive": "1",
  "shortName": "John",
  "parentCustomerId": "12345",
  "companyName": "A company",
  "contactFirstName": "John",
  "contactLastName": "Doe"
}
Connection

The Bill.com connection to use.

Customer Name

The name of the customer.

John
Example Payload for Create Customer⤓
Loading…

Create Customer Bank Account​

Create a customer bank account object. | key: createCustomerBankAccount

InputNotesExample
Account Number

The customer bank account number.

0112345678
Additional Fields

Additional fields that might not be covered by the standard inputs. See https://developer.bill.com/reference/createcustomerbankaccount for more information.

{
  "isActive": "string",
  "nickname": "string",
  "isLockedByOrg": true,
  "isSavings": "string",
  "isPersonalAcct": "string",
  "isWrittenAuth": true,
  "isPrivate": true,
  "phone": "string",
  "cpUserId": "string"
}
Agreed with TOS

When true, indicates agreement with the BILL Payment Terms Of Service.

true
Connection

The Bill.com connection to use.

Customer ID

The unique identifier for the customer.

0cu...
Name on Account

Customer bank account name.

Account Name
Routing Number

The customer bank routing number.

012345678
Example Payload for Create Customer Bank Account⤓
Loading…

Create Invoice​

Create an invoice object. | key: createInvoice

InputNotesExample
Additional Fields

Additional fields that might not be covered by the standard inputs. See https://developer.bill.com/reference/createinvoice for more information.

{
  "isActive": "1",
  "glPostingDate": "2024-04-10",
  "description": "Description",
  "isToBePrinted": true
}
Connection

The Bill.com connection to use.

Customer ID

The unique identifier for the customer.

0cu...
Due Date

Date when the invoice is due. The value is in the YYYY-MM-DD format.

2024-04-10
Invoice Date

Date when the invoice is issued to the customer. This value is in the YYYY-MM-DD format.

2024-04-10
Invoice Line Items

An array of invoice line items.

[
  {
    "entity": "InvoiceLineItem",
    "quantity": 1,
    "itemId": "0ii...",
    "price": 100
  }
]
Invoice Number

User-generated invoice number. This value can be your chosen number scheme or invoice due date.

00e02DTF...
Example Payload for Create Invoice⤓
Loading…

Create Vendor​

Create a vendor object. | key: createVendor

InputNotesExample
Additional Fields

Additional fields that might not be covered by the standard inputs. See https://developer.bill.com/reference/createvendor for more information.

{
  "isActive": "string",
  "shortName": "string",
  "nameOnCheck": "string",
  "accNumber": "string",
  "taxId": "string",
  "taxIdType": "string",
  "track1099": true,
  "address1": "string",
  "address2": "string",
  "address3": "string",
  "address4": "string",
  "addressCity": "string",
  "addressState": "string",
  "addressZip": "string",
  "addressCountry": "string",
  "fax": "string",
  "phone": "string",
  "paymentEmail": "string",
  "paymentPhone": "string",
  "description": "string",
  "contactFirstName": "string",
  "contactLastName": "string",
  "accountType": "string",
  "paymentTermId": "string",
  "sendNotifications": true,
  "externalBillPayIn12m": 0,
  "since": 0,
  "payDaysBefore": 0,
  "enabledCombinePayments": true,
  "billCurrency": "string",
  "billSyncPref": "string",
  "prefPmtMethod": "string",
  "paymentPurpose": "string",
  "bankCountry": "string",
  "sendInviteForPrivateVendor": true,
  "vendorVCardRemitEmail": "string",
  "vendorVCardStatus": "string",
  "orgVCardStatus": "string",
  "prefRemitEmail": "string",
  "remitEmail": "string",
  "processorVCardStatus": "string",
  "vStatusUpdateSource": "string",
  "orgVCardOptOutCustReason": "string",
  "enableFundedInvite": true,
  "lastPaymentDate": "string",
  "numberOfInvitesSent": 0,
  "eligibleForEbills": true,
  "acknowledgedEbillBanner": true,
  "acknowledgedEbillError": true,
  "eBillEnablementFailed": true,
  "PaymentusMerchantId": "string",
  "unmodifiedBillsCount": "string",
  "setupAutoPayPrompt": true,
  "autoSave": "string",
  "creationSource": "string",
  "PaymentusPmtType": "string",
  "PaymentusAcctToken": "string",
  "PaymentusAcctToken2": "string",
  "PaymentusAcctToken3": "string",
  "stpProcessor": "string",
  "eBillEnabledStatus": "string"
}
Company Name

Vendor organization full name.

Example Company
Connection

The Bill.com connection to use.

Email

Vendor email address.

example@email.com
Vendor Name

Unique vendor name.

Example Vendor
Example Payload for Create Vendor⤓
Loading…

Create Vendor Bank Account​

Create a vendor bank account object. | key: createVendorBankAccount

InputNotesExample
Account Number

The vendor bank account number.

0112345678
Additional Fields

Additional fields that might not be covered by the standard inputs. See https://developer.bill.com/reference/createvendorbankaccount for more information.

{
  "isActive": "string",
  "nameOnAcct": "string",
  "usersId": "string",
  "isSavings": true,
  "isPersonalAcct": true,
  "intlPaymentType": "string",
  "paymentCurrency": "string",
  "vendorBankData": "string",
  "bankAddSource": "string",
  "intlTemplateKey": "string",
  "regulatory1": "string",
  "regulatory2": "string",
  "regulatory3": "string",
  "regulatory4": "string",
  "regulatory5": "string",
  "regulatory6": "string",
  "regulatory7": "string"
}
Connection

The Bill.com connection to use.

Device ID

The unique identifier for the device. Retrieved from the 'Authenticate MFA session' action.

Acme-...
MFA ID

The unique identifier for the MFA session. Retrieved from the 'Authenticate MFA session' action.

!b_EJCd_jPIsZYT...
Routing Number

The vendor bank routing number.

012345678
Vendor ID

The unique identifier for the vendor.

009...
Example Payload for Create Vendor Bank Account⤓
Loading…

Delete Bill​

Delete a bill object. | key: deleteBill

InputNotesExample
Bill ID

The unique identifier for the bill.

00n...
Connection

The Bill.com connection to use.

Example Payload for Delete Bill⤓
Loading…

Delete Customer​

Delete a customer object. | key: deleteCustomer

InputNotesExample
Connection

The Bill.com connection to use.

Customer ID

The unique identifier for the customer.

0cu...
Example Payload for Delete Customer⤓
Loading…

Delete Invoice​

Delete an invoice object. | key: deleteInvoice

InputNotesExample
Connection

The Bill.com connection to use.

Invoice ID

The ID of the invoice.

00e...
Example Payload for Delete Invoice⤓
Loading…

Delete Vendor​

Delete a vendor object. | key: deleteVendor

InputNotesExample
Connection

The Bill.com connection to use.

Vendor ID

The unique identifier for the vendor.

009...
Example Payload for Delete Vendor⤓
Loading…

Delete Vendor Bank Account​

Delete a vendor bank account object. | key: deleteVendorBankAccount

InputNotesExample
Connection

The Bill.com connection to use.

Device ID

The unique identifier for the device. Retrieved from the 'Authenticate MFA session' action.

Acme-...
MFA ID

The unique identifier for the MFA session. Retrieved from the 'Authenticate MFA session' action.

!b_EJCd_jPIsZYT...
Vendor Bank Account ID

ID of the vendor bank account.

vba...
Example Payload for Delete Vendor Bank Account⤓
Loading…

Generate an MFA Challenge ID​

Use this action to create a trusted MFA session. | key: generateMfaChallengeId

InputNotesExample
Connection

The Bill.com connection to use.

Use backup

When true, uses the backup mobile device for MFA.

false
Example Payload for Generate an MFA Challenge ID⤓
Loading…

Get Bill​

Read a bill object. | key: getBill

InputNotesExample
Bill ID

The unique identifier for the bill.

00n...
Connection

The Bill.com connection to use.

Example Payload for Get Bill⤓
Loading…

Get Customer​

Read a customer object. | key: getCustomer

InputNotesExample
Connection

The Bill.com connection to use.

Customer ID

The unique identifier for the customer.

0cu...
Example Payload for Get Customer⤓
Loading…

Get Customer Bank Account​

Read a customer bank account object. | key: getCustomerBankAccount

InputNotesExample
Connection

The Bill.com connection to use.

Customer Bank Account ID

ID of the customer bank account.

cba...
Example Payload for Get Customer Bank Account⤓
Loading…

Get Invoice​

Read an invoice object. | key: getInvoice

InputNotesExample
Connection

The Bill.com connection to use.

Invoice ID

The ID of the invoice.

00e...
Example Payload for Get Invoice⤓
Loading…

Get Vendor​

Read a vendor object. | key: getVendor

InputNotesExample
Connection

The Bill.com connection to use.

Vendor ID

The unique identifier for the vendor.

009...
Example Payload for Get Vendor⤓
Loading…

Get Vendor Bank Account​

Read a vendor bank account object. | key: getVendorBankAccount

InputNotesExample
Connection

The Bill.com connection to use.

Vendor Bank Account ID

ID of the vendor bank account.

vba...
Example Payload for Get Vendor Bank Account⤓
Loading…

List Bills​

List bill objects. | key: listBills

InputNotesExample
Connection

The Bill.com connection to use.

Filters

An array of filters to apply. See Bill.com API documentation for more information.

[
  {
    "field": "field1",
    "op": "=",
    "value": "something"
  }
]
Max

Maximum number of results to return.

999
Nested

When true, includes additional nested data in the response.

false
Sort

An array of sort objects. See Bill.com API documentation for more information.

[
  {
    "field": "field1",
    "asc": true
  }
]
Start

Index of the first result.

0
Example Payload for List Bills⤓
Loading…

List Customer Bank Account​

List customer bank account objects. | key: listCustomerBankAccount

InputNotesExample
Connection

The Bill.com connection to use.

Filters

An array of filters to apply. See Bill.com API documentation for more information.

[
  {
    "field": "field1",
    "op": "=",
    "value": "something"
  }
]
Max

Maximum number of results to return.

999
Nested

When true, includes additional nested data in the response.

false
Sort

An array of sort objects. See Bill.com API documentation for more information.

[
  {
    "field": "field1",
    "asc": true
  }
]
Start

Index of the first result.

0
Example Payload for List Customer Bank Account⤓
Loading…

List Customers​

List customer objects. | key: listCustomer

InputNotesExample
Connection

The Bill.com connection to use.

Filters

An array of filters to apply. See Bill.com API documentation for more information.

[
  {
    "field": "field1",
    "op": "=",
    "value": "something"
  }
]
Max

Maximum number of results to return.

999
Nested

When true, includes additional nested data in the response.

false
Sort

An array of sort objects. See Bill.com API documentation for more information.

[
  {
    "field": "field1",
    "asc": true
  }
]
Start

Index of the first result.

0
Example Payload for List Customers⤓
Loading…

List Invoices​

List invoice objects. | key: listInvoice

InputNotesExample
Connection

The Bill.com connection to use.

Filters

An array of filters to apply. See Bill.com API documentation for more information.

[
  {
    "field": "field1",
    "op": "=",
    "value": "something"
  }
]
Max

Maximum number of results to return.

999
Nested

When true, includes additional nested data in the response.

false
Sort

An array of sort objects. See Bill.com API documentation for more information.

[
  {
    "field": "field1",
    "asc": true
  }
]
Start

Index of the first result.

0
Example Payload for List Invoices⤓
Loading…

List Vendor Bank Accounts​

List vendor bank account objects. | key: listVendorBankAccounts

InputNotesExample
Connection

The Bill.com connection to use.

Filters

An array of filters to apply. See Bill.com API documentation for more information.

[
  {
    "field": "field1",
    "op": "=",
    "value": "something"
  }
]
Max

Maximum number of results to return.

999
Nested

When true, includes additional nested data in the response.

false
Sort

An array of sort objects. See Bill.com API documentation for more information.

[
  {
    "field": "field1",
    "asc": true
  }
]
Start

Index of the first result.

0
Example Payload for List Vendor Bank Accounts⤓
Loading…

List Vendors​

List vendor objects. | key: listVendors

InputNotesExample
Connection

The Bill.com connection to use.

Filters

An array of filters to apply. See Bill.com API documentation for more information.

[
  {
    "field": "field1",
    "op": "=",
    "value": "something"
  }
]
Max

Maximum number of results to return.

999
Nested

When true, includes additional nested data in the response.

false
Sort

An array of sort objects. See Bill.com API documentation for more information.

[
  {
    "field": "field1",
    "asc": true
  }
]
Start

Index of the first result.

0
Example Payload for List Vendors⤓
Loading…

Raw Request​

Send raw HTTP request to Bill. | key: rawRequest

InputNotesExample
Connection

The Bill.com connection to use.

Data

The HTTP body payload to send to the URL.

{"exampleKey": "Example Data"}
File Data

File Data to be sent as a multipart form upload.

[{key: "example.txt", value: "My File Contents"}]
File Data File Names

File names to apply to the file data inputs. Keys must match the file data keys above.

Form Data

The Form Data to be sent as a multipart form upload.

[{"key": "Example Key", "value": new Buffer("Hello World")}]
Header

A list of headers to send with the request.

User-Agent: curl/7.64.1
Max Retry Count

The maximum number of retries to attempt. Specify 0 for no retries.

0
Method

The HTTP method to use.

Query Parameter

A list of query parameters to send with the request. This is the portion at the end of the URL similar to ?key1=value1&key2=value2.

Response Type

The type of data you expect in the response. You can request json, text, or binary data.

json
Retry On All Errors

If true, retries on all erroneous responses regardless of type. This is helpful when retrying after HTTP 429 or other 3xx or 4xx errors. Otherwise, only retries on HTTP 5xx and network errors.

false
Retry Delay (ms)

The delay in milliseconds between retries. This is used when 'Use Exponential Backoff' is disabled.

0
Timeout

The maximum time that a client will await a response to its request

2000
URL

Input the path only (/Login.json), The base URL is already included (https://api.bill.com/api/v2). For example, to connect to https://api.bill.com/api/v2/Login.json, only /Login.json is entered in this field.

/Login.json
Use Exponential Backoff

Specifies whether to use a pre-defined exponential backoff strategy for retries. When enabled, 'Retry Delay (ms)' is ignored.

false

Update Bill​

Update a bill object. | key: updateBill

InputNotesExample
Additional Fields

Additional fields that might not be covered by the standard inputs. See https://developer.bill.com/reference/updatebill for more information.

{
  "entity": "Bill",
  "isActive": "string",
  "glPostingDate": "string",
  "exchangeRate": 0,
  "description": "string",
  "poNumber": "string",
  "payFromBankAccountId": "string",
  "payFromChartOfAccountId": "string",
  "paymentTermId": "string",
  "hasAutoPay": true,
  "eBillCreated": true,
  "invoiceProductId": "string",
  "chartOfAccountId": "string",
  "departmentId": "string",
  "locationId": "string",
  "actgClassId": "string",
  "source": "string",
  "useBillDesc": true,
  "defaultInvoiceNumber": true,
  "isAutoSaved": true,
  "billTemplateId": "string"
}
Allow Duplicate Invoice Number

Allow duplicate invoice numbers.

Bill ID

The unique identifier for the bill.

00n...
Bill Line Items

An array of bill line items. See Bill.com API documentation for more information.

[
  {
    "entity": "BillLineItem",
    "amount": 0,
    "chartOfAccountId": "string",
    "departmentId": "string",
    "locationId": "string",
    "jobId": "string",
    "customerId": "string",
    "jobBillable": true,
    "description": "string",
    "lineType": "string",
    "itemId": "string",
    "quantity": 0,
    "unitPrice": 0,
    "employeeId": "string",
    "actgClassId": "string",
    "purchaseOrderBillLinkId": "string",
    "unitOfMeasureId": "string",
    "lineOrder": 0,
    "cdFieldId1": "string",
    "cdFieldId2": "string",
    "cdFieldId3": "string",
    "cdFieldId4": "string",
    "cdFieldId5": "string",
    "cdFieldId6": "string",
    "useSmartApprovers": true
  }
]
Connection

The Bill.com connection to use.

Due Date

Date when the bill is due. The value is in the YYYY-MM-DD format.

2021-01-01
Invoice Date

Date when the bill is sent. This value is in the YYYY-MM-DD format.

2021-01-01
Invoice Number

User-generated invoice number. This value can be your chosen number scheme or bill due date.

01
Vendor ID

The unique identifier for the vendor.

009...
Example Payload for Update Bill⤓
Loading…

Update Customer​

Update a customer object. | key: updateCustomer

InputNotesExample
Additional Fields

Additional fields that might not be covered by the standard inputs. See https://developer.bill.com/reference/updatecustomer for more information.

{
  "isActive": "1",
  "shortName": "John",
  "parentCustomerId": "12345",
  "companyName": "A company",
  "contactFirstName": "John",
  "contactLastName": "Doe"
}
Connection

The Bill.com connection to use.

Customer ID

The unique identifier for the customer.

0cu...
Customer Name

The name of the customer.

John
Example Payload for Update Customer⤓
Loading…

Update Invoice​

Update an invoice object. | key: updateInvoice

InputNotesExample
Additional Fields

Additional fields that might not be covered by the standard inputs.

{
  "customField": "value"
}
Connection

The Bill.com connection to use.

Customer ID

The unique identifier for the customer.

0cu...
Due Date

Date when the invoice is due. The value is in the YYYY-MM-DD format.

2024-04-10
Invoice Date

Date when the invoice is issued to the customer. This value is in the YYYY-MM-DD format.

2024-04-10
Invoice ID

The ID of the invoice.

00e...
Invoice Line Items

An array of invoice line items.

[
  {
    "entity": "InvoiceLineItem",
    "quantity": 1,
    "itemId": "0ii...",
    "price": 100
  }
]
Invoice Number

User-generated invoice number. This value can be your chosen number scheme or invoice due date.

00e02DTF...
Example Payload for Update Invoice⤓
Loading…

Update Vendor​

Update a vendor object. | key: updateVendor

InputNotesExample
Additional Fields

Additional fields that might not be covered by the standard inputs. See https://developer.bill.com/reference/updatevendor for more information.

{
  "isActive": "string",
  "shortName": "string",
  "nameOnCheck": "string",
  "accNumber": "string",
  "taxId": "string",
  "taxIdType": "string",
  "track1099": true,
  "address1": "string",
  "address2": "string",
  "address3": "string",
  "address4": "string",
  "addressCity": "string",
  "addressState": "string",
  "addressZip": "string",
  "addressCountry": "string",
  "fax": "string",
  "phone": "string",
  "paymentEmail": "string",
  "paymentPhone": "string",
  "description": "string",
  "contactFirstName": "string",
  "contactLastName": "string",
  "accountType": "string",
  "paymentTermId": "string",
  "sendNotifications": true,
  "externalBillPayIn12m": 0,
  "since": 0,
  "payDaysBefore": 0,
  "enabledCombinePayments": true,
  "billCurrency": "string",
  "billSyncPref": "string",
  "prefPmtMethod": "string",
  "paymentPurpose": "string",
  "bankCountry": "string",
  "sendInviteForPrivateVendor": true,
  "vendorVCardRemitEmail": "string",
  "vendorVCardStatus": "string",
  "orgVCardStatus": "string",
  "prefRemitEmail": "string",
  "remitEmail": "string",
  "processorVCardStatus": "string",
  "vStatusUpdateSource": "string",
  "orgVCardOptOutCustReason": "string",
  "enableFundedInvite": true,
  "lastPaymentDate": "string",
  "numberOfInvitesSent": 0,
  "eligibleForEbills": true,
  "acknowledgedEbillBanner": true,
  "acknowledgedEbillError": true,
  "eBillEnablementFailed": true,
  "PaymentusMerchantId": "string",
  "unmodifiedBillsCount": "string",
  "setupAutoPayPrompt": true,
  "autoSave": "string",
  "creationSource": "string",
  "PaymentusPmtType": "string",
  "PaymentusAcctToken": "string",
  "PaymentusAcctToken2": "string",
  "PaymentusAcctToken3": "string",
  "stpProcessor": "string",
  "eBillEnabledStatus": "string"
}
Connection

The Bill.com connection to use.

Vendor Name

Unique vendor name.

Example Vendor
Vendor ID

The unique identifier for the vendor.

009...
Example Payload for Update Vendor⤓
Loading…

Changelog​

2026-05-05​

Added New and Updated Records polling trigger to detect new and updated records for a selected Bill.com resource type on a configured schedule

2026-04-30​

Updated spectral version

2026-03-16​

Improved input field documentation with formatted URL links for better readability

2026-02-24​

Added inline data sources for Customer ID and Vendor ID inputs to enhance data selection capabilities

2026-02-05​

  • Enhanced input field documentation with improved placeholders and comments
  • Standardized connection documentation with proper setup instructions