BILL

Manage accounts payable and receivable in BILL: vendors, bills, customers, invoices, payments and payment terms.

Actions

Action	What it does
Archive a vendor	Archive a vendor so it no longer appears in BILL's active lists.
Create a bill	Record a bill a vendor has sent you.
Create a customer	Add a customer you invoice.
Create a vendor	Add a vendor to BILL.
Create an invoice	Issue an invoice to a customer.
Get a bill	Get one bill in full, including its approvers.
Get a customer	Get one customer's full record.
Get a vendor	Get one vendor's full record.
Get an invoice	Get one invoice in full, with its lines and payments.
Get organization	Get your BILL organization's profile: name, address, tax details and account type.
Get session info	Check the BILL connection and report which organization and user it is signed in as.
List bills	List the bills you owe.
List customers	List the customers on your BILL organization.
List invoices	List the invoices you have issued to customers.
List payment terms	List the payment terms set up on the organization, with the id bills, customers and invoices refer to.
List payments	List payments already made or scheduled.
List vendors	List the vendors on your BILL organization.
Update a bill	Change a bill.
Update a customer	Change a customer's details.
Update a vendor	Change a vendor's details.

Archive a vendor

Archive a vendor so it no longer appears in BILL's active lists. BILL has no delete for vendors, and archiving an already archived vendor changes nothing.

Inputs

Vendorvendor_idtextRequired: The vendor's BILL id, which begins 009. Use 'List vendors' to find one; the id also appears in the vendor's BILL web address.

Outputs

archivedtrue/false: True once BILL reports the vendor archived.
statustext: Status of the action execution ("success" on success).
vendorobject: The vendor after archiving.
vendor_idtext: The vendor that was archived.

Example output

{
  "archived": true,
  "status": "success",
  "vendor": {
    "archived": true,
    "id": "00901ACMEVENDORRECORD",
    "name": "Northwind Paper Co"
  },
  "vendor_id": "00901ACMEVENDORRECORD"
}

Create a bill

Record a bill a vendor has sent you. The invoice number and date are the ones on the vendor's own document.

Inputs

Vendorvendor_idtextRequired: The vendor's BILL id, which begins 009. Use 'List vendors' to find one; the id also appears in the vendor's BILL web address.
Vendor invoice numberinvoice_numbertextRequired: The number the vendor put on their invoice.
Invoice dateinvoice_datedateRequired: The date on the vendor's invoice.
Due datedue_datedateRequired: When the bill has to be paid.
Amountamountnumber: The bill's amount, which becomes its single line. Leave blank only if you are filling in Line items.
Line descriptionline_descriptiontext: What that single line is for.
Line itemsline_itemslist: Several lines instead of one amount. Each takes an amount, and optionally a quantity, price and description.
Descriptiondescriptiontext: A note about the bill as a whole.
Payment termpayment_term_idtext: The payment term to apply to this bill.
Pay from accountpay_from_chart_of_account_idtext: A chart-of-accounts id (beginning 0ca) to pay this bill from.
Purchase order numberpurchase_order_numbertext: Your PO number for this bill.

Outputs

billobject: The bill that was created.
bill_idtext: The new bill's id.
statustext: Status of the action execution ("success" on success).

Example output

{
  "bill": {
    "amount": 420.5,
    "dueDate": "2026-10-15",
    "id": "00n01ACMEBILLRECORD1",
    "vendorId": "00901ACMEVENDORRECORD"
  },
  "bill_id": "00n01ACMEBILLRECORD1",
  "status": "success"
}

Create a customer

Add a customer you invoice. BILL requires a name and an email address.

Inputs

Customer namenametextRequired: The customer's name, as it should appear in BILL.
EmailemailtextRequired: Where invoices go. BILL requires one on every customer.
Company namecompany_nametext: The customer's company name, if it differs from the name.
Contact first namecontact_first_nametext: Given name of the person you deal with.
Contact last namecontact_last_nametext: Family name of the person you deal with.
Phonephonetext: The customer's phone number.
Faxfaxtext: The customer's fax number.
Descriptiondescriptiontext: A note about this customer, kept on their record.
Invoice currencyinvoice_currencytext: Three-letter currency code their invoices are issued in, such as USD, CAD, EUR or GBP.
Account typeaccount_typetext: Whether the customer is a business or a person.One of: NONE, BUSINESS, PERSON.
Payment termpayment_term_idtext: How long the customer has to pay an invoice. Sets the default term on their invoices.
Account numberaccount_numbertext: Your reference for this customer. It appears on invoices.
Billing address streetbilling_address_line1text: Street address. If you fill in any part of the address, street, city, postal code and country are all required.
Billing address street line 2billing_address_line2text: Suite, floor or unit.
Billing address citybilling_address_citytext: City or town.
Billing address state or provincebilling_address_state_or_provincetext: State, province or region.
Billing address postal codebilling_address_zip_or_postal_codetext: ZIP or postal code.
Billing address countrybilling_address_countrytext: Two-letter country code, such as US, CA or GB.

Outputs

customerobject: The customer that was created.
customer_idtext: The new customer's id.
statustext: Status of the action execution ("success" on success).

Example output

{
  "customer": {
    "email": "billing@harbour.example",
    "id": "0cu01ACMECUSTOMERREC",
    "name": "Harbour Design Studio"
  },
  "customer_id": "0cu01ACMECUSTOMERREC",
  "status": "success"
}

Create a vendor

Add a vendor to BILL. An address is required: street, city, postal code and country.

Inputs

Vendor namenametextRequired: The vendor's name, as it should appear in BILL.
Address streetaddress_line1textRequired: Street address. BILL requires an address on a new vendor.
Address street line 2address_line2text: Suite, floor or unit.
Address cityaddress_citytextRequired: City or town.
Address state or provinceaddress_state_or_provincetext: State, province or region.
Address postal codeaddress_zip_or_postal_codetextRequired: ZIP or postal code.
Address countryaddress_countrytextRequired: Two-letter country code, such as US, CA or GB.
Short nameshort_nametext: A shorter name for the vendor, used on lists and reports.
Your account numberaccount_numbertext: Your account number with this vendor -- the one on their billing statement.
Account typeaccount_typetext: Whether the vendor is a business or a person.One of: NONE, BUSINESS, PERSON.
Emailemailtext: The vendor's email address.
Phonephonetext: The vendor's phone number.
Bill currencybill_currencytext: Three-letter currency code their bills are issued in, such as USD, CAD, EUR or GBP.
Legal company namecompany_nametext: The vendor's registered company name, if it differs.
Tax IDtax_idtext: The vendor's tax identification number.
Tax ID typetax_id_typetext: Which kind of tax ID that is.One of: EIN, SSN.
Track for 1099track_1099true/false: Include this vendor's payments in 1099 reporting.
Payment lead time (days)lead_time_in_daysnumber: How many days ahead this vendor's payments must be sent.From 0 to 365.
Combine paymentscombine_paymentstrue/false: Pay several bills from this vendor in one payment.
Payment termpayment_term_idtext: The payment term to apply to this vendor's bills.

Outputs

statustext: Status of the action execution ("success" on success).
vendorobject: The vendor that was created.
vendor_idtext: The new vendor's id.

Example output

{
  "status": "success",
  "vendor": {
    "archived": false,
    "id": "00901ACMEVENDORRECORD",
    "name": "Northwind Paper Co"
  },
  "vendor_id": "00901ACMEVENDORRECORD"
}

Create an invoice

Issue an invoice to a customer. Leave the invoice number blank and BILL generates one.

Inputs

Customercustomer_idtextRequired: The customer's BILL id, which begins 0cu. Use 'List customers' to find one.
Quantityquantitynumber: How many units the single line is for. BILL requires a quantity on every line.
Unit pricepricenumber: What one unit costs.
Line descriptionline_descriptiontext: What that single line is for.
Line itemsline_itemslist: Several lines instead of one. Each needs a quantity, and optionally a price, description and taxable flag.
Invoice numberinvoice_numbertext: Your number for this invoice. Leave blank to let BILL generate one.
Invoice dateinvoice_datedate: The invoice's date. Defaults to today.
Due datedue_datedate: When the customer has to pay.
Payment termpayment_term_idtext: The payment term for this invoice, which sets how long the customer has to pay.
Pay into accountpay_to_chart_of_account_idtext: A chart-of-accounts id (beginning 0ca) the payment should land in.
Allow card paymentenable_card_paymenttrue/false: Let the customer pay this invoice by card.
Email it to the customersend_emailtrue/false: On sends the invoice to the customer's email address immediately. Off (the default) creates it quietly.Default: false.

Outputs

emailedtrue/false: True when BILL was asked to email the customer.
invoiceobject: The invoice that was created.
invoice_idtext: The new invoice's id.
statustext: Status of the action execution ("success" on success).

Example output

{
  "emailed": false,
  "invoice": {
    "customerId": "0cu01ACMECUSTOMERREC",
    "id": "00e01ACMEINVOICEREC1",
    "invoiceNumber": "INV-1042",
    "totalAmount": 1250.0
  },
  "invoice_id": "00e01ACMEINVOICEREC1",
  "status": "success"
}

Get a bill

Get one bill in full, including its approvers.

Inputs

Billbill_idtextRequired: The bill's BILL id, which begins 00n. Use 'List bills' to find one.

Outputs

billobject: The bill's record.
statustext: Status of the action execution ("success" on success).

Example output

{
  "bill": {
    "amount": 420.5,
    "dueDate": "2026-10-15",
    "id": "00n01ACMEBILLRECORD1",
    "paymentStatus": "UNPAID",
    "vendorId": "00901ACMEVENDORRECORD"
  },
  "status": "success"
}

Get a customer

Get one customer's full record.

Inputs

Customercustomer_idtextRequired: The customer's BILL id, which begins 0cu. Use 'List customers' to find one.

Outputs

customerobject: The customer's record.
statustext: Status of the action execution ("success" on success).

Example output

{
  "customer": {
    "email": "billing@harbour.example",
    "id": "0cu01ACMECUSTOMERREC",
    "name": "Harbour Design Studio"
  },
  "status": "success"
}

Get a vendor

Get one vendor's full record.

Inputs

Vendorvendor_idtextRequired: The vendor's BILL id, which begins 009. Use 'List vendors' to find one; the id also appears in the vendor's BILL web address.

Outputs

statustext: Status of the action execution ("success" on success).
vendorobject: The vendor's record.

Example output

{
  "status": "success",
  "vendor": {
    "archived": false,
    "billCurrency": "USD",
    "id": "00901ACMEVENDORRECORD",
    "name": "Northwind Paper Co"
  }
}

Get an invoice

Get one invoice in full, with its lines and payments.

Inputs

Invoiceinvoice_idtextRequired: The invoice's BILL id, which begins 00e. Use 'List invoices' to find one.

Outputs

invoiceobject: The invoice's record.
statustext: Status of the action execution ("success" on success).

Example output

{
  "invoice": {
    "customerId": "0cu01ACMECUSTOMERREC",
    "id": "00e01ACMEINVOICEREC1",
    "invoiceNumber": "INV-1042",
    "status": "OPEN",
    "totalAmount": 1250.0
  },
  "status": "success"
}

Get organization

Get your BILL organization's profile: name, address, tax details and account type.

Inputs

Organizationorganization_idtext: A BILL organization id, beginning 008. Leave blank for the organization this connection signs in to.

Outputs

organizationobject: The organization's profile.
organization_idtext: The organization that was read.
statustext: Status of the action execution ("success" on success).

Example output

{
  "organization": {
    "accountType": "BUSINESS",
    "id": "00801ACMEORGANIZATION",
    "name": "Acme Supplies Inc",
    "phone": "415-555-0142"
  },
  "organization_id": "00801ACMEORGANIZATION",
  "status": "success"
}

Get session info

Check the BILL connection and report which organization and user it is signed in as.

Inputs

None.

Outputs

mfa_bypasstrue/false: True when MFA is disabled at the developer-key level.
organization_idtext: The organization this connection acts on.
sessionobject: The signed-in session, as BILL reports it.
statustext: Status of the action execution ("success" on success).
user_idtext: The BILL user the connection signs in as.

Example output

{
  "mfa_bypass": false,
  "organization_id": "00801ACMEORGANIZATION",
  "session": {
    "mfaBypass": false,
    "organizationId": "00801ACMEORGANIZATION",
    "userId": "00601ACMEUSERRECORDID"
  },
  "status": "success",
  "user_id": "00601ACMEUSERRECORDID"
}

List bills

List the bills you owe. The rows carry everything a single bill does except its approvers: use 'Get a bill' for those.

Inputs

Vendorvendor_idtext: Only return bills from this vendor (an id beginning 009). Leave blank for every vendor.
Payment statuspayment_statustext: Only return bills in this payment status.One of: PAID, UNPAID, PARTIALLY_PAID (Partially paid), SCHEDULED, IN_PROCESS (In process).
Archived onlyarchivedtrue/false: On returns only archived records, off only active ones. Leave unset for both.
Due on or afterdue_on_or_afterdate: Only return bills due on or after this date.
Due on or beforedue_on_or_beforedate: Only return bills due on or before this date.
Created on or aftercreated_on_or_afterdate: Only return records created on or after this date.
Maximum resultsmax_resultsnumber: How many records to return on this page (1-100). BILL returns 20 when this is blank.From 1 to 100.
Pagepagetext: The 'Next page' value from an earlier run of this action. Leave blank for the first page.
Sort bysort_bytext: Which field to sort on. Leave blank for BILL's own order.One of: dueDate, createdTime, updatedTime.
Sort directionsort_directiontext: Which way to sort. Ascending unless you choose otherwise.One of: asc, desc.

Outputs

billslist: The bills that matched.
countnumber: How many bills this page carried.
next_pagetext: Cursor for the next page, or empty when this is the last one. Pass it back as 'Page'.
prev_pagetext: Cursor for the previous page, when there is one.
statustext: Status of the action execution ("success" on success).
total_countnumber: How many bills matched in total, across all pages.
total_due_amountnumber: The total amount still due across everything matched.

Example output

{
  "bills": [
    {
      "amount": 420.5,
      "dueDate": "2026-10-15",
      "id": "00n01ACMEBILLRECORD1",
      "paymentStatus": "UNPAID",
      "vendorId": "00901ACMEVENDORRECORD",
      "vendorName": "Northwind Paper Co"
    }
  ],
  "count": 1,
  "next_page": "",
  "prev_page": "",
  "status": "success",
  "total_count": 1,
  "total_due_amount": 420.5
}

List customers

List the customers on your BILL organization.

Inputs

Name starts withnametext: Only return customers whose name starts with this.
Archived onlyarchivedtrue/false: On returns only archived records, off only active ones. Leave unset for both.
Account typeaccount_typetext: Only return records of this account type.One of: NONE, BUSINESS, PERSON.
Created on or aftercreated_on_or_afterdate: Only return records created on or after this date.
Updated on or afterupdated_on_or_afterdate: Only return records changed on or after this date.
Maximum resultsmax_resultsnumber: How many records to return on this page (1-100). BILL returns 20 when this is blank.From 1 to 100.
Pagepagetext: The 'Next page' value from an earlier run of this action. Leave blank for the first page.
Sort bysort_bytext: Which field to sort on. Leave blank for BILL's own order.One of: name, createdTime, updatedTime.
Sort directionsort_directiontext: Which way to sort. Ascending unless you choose otherwise.One of: asc, desc.

Outputs

countnumber: How many customers this page carried.
customerslist: The customers that matched.
next_pagetext: Cursor for the next page, or empty when this is the last one. Pass it back as 'Page'.
prev_pagetext: Cursor for the previous page, when there is one.
statustext: Status of the action execution ("success" on success).

Example output

{
  "count": 1,
  "customers": [
    {
      "archived": false,
      "email": "billing@harbour.example",
      "id": "0cu01ACMECUSTOMERREC",
      "name": "Harbour Design Studio"
    }
  ],
  "next_page": "",
  "prev_page": "",
  "status": "success"
}

List invoices

List the invoices you have issued to customers.

Inputs

Customercustomer_idtext: Only return invoices for this customer (an id beginning 0cu). Leave blank for every customer.
Statusstatustext: Only return invoices in this status.One of: PAID_IN_FULL (Paid in full), OPEN, PARTIAL_PAYMENT (Partial payment), SCHEDULED.
Archived onlyarchivedtrue/false: On returns only archived records, off only active ones. Leave unset for both.
Created on or aftercreated_on_or_afterdate: Only return records created on or after this date.
Updated on or afterupdated_on_or_afterdate: Only return records changed on or after this date.
Maximum resultsmax_resultsnumber: How many records to return on this page (1-100). BILL returns 20 when this is blank.From 1 to 100.
Pagepagetext: The 'Next page' value from an earlier run of this action. Leave blank for the first page.
Sort bysort_bytext: Which field to sort on. Leave blank for BILL's own order.One of: createdTime, updatedTime.
Sort directionsort_directiontext: Which way to sort. Ascending unless you choose otherwise.One of: asc, desc.

Outputs

countnumber: How many invoices this page carried.
invoiceslist: The invoices that matched.
next_pagetext: Cursor for the next page, or empty when this is the last one. Pass it back as 'Page'.
prev_pagetext: Cursor for the previous page, when there is one.
statustext: Status of the action execution ("success" on success).
total_countnumber: How many invoices matched in total, across all pages.
total_due_amountnumber: The total amount still due across everything matched.

Example output

{
  "count": 1,
  "invoices": [
    {
      "customerId": "0cu01ACMECUSTOMERREC",
      "id": "00e01ACMEINVOICEREC1",
      "invoiceNumber": "INV-1042",
      "status": "OPEN",
      "totalAmount": 1250.0
    }
  ],
  "next_page": "",
  "prev_page": "",
  "status": "success",
  "total_count": 1,
  "total_due_amount": 1250.0
}

List payment terms

List the payment terms set up on the organization, with the id bills, customers and invoices refer to.

Inputs

Organizationorganization_idtext: A BILL organization id, beginning 008. Leave blank for the organization this connection signs in to.
Days to paydays_duenumber: Only return terms with exactly this many days to pay, such as 30 for Net 30.From 0 to 365.
Maximum resultsmax_resultsnumber: How many records to return on this page (1-100). BILL returns 20 when this is blank.From 1 to 100.
Sort bysort_bytext: Which field to sort on. Leave blank for BILL's own order.One of: name, createdTime, updatedTime.
Sort directionsort_directiontext: Which way to sort. Ascending unless you choose otherwise.One of: asc, desc.

Outputs

countnumber: How many payment terms this page carried.
next_pagetext: Cursor for the next page, or empty when this is the last one. Pass it back as 'Page'.
payment_termslist: The payment terms that matched.
prev_pagetext: Cursor for the previous page, when there is one.
statustext: Status of the action execution ("success" on success).

Example output

{
  "count": 1,
  "next_page": "",
  "payment_terms": [
    {
      "daysDue": 30,
      "id": "00p01ACMEPAYMENTTERM",
      "name": "Net 30"
    }
  ],
  "prev_page": "",
  "status": "success"
}

List payments

List payments already made or scheduled. Making a payment needs an SMS-verified BILL session, so this integration reads payments but never creates one.

Inputs

Vendorvendor_idtext: Only return payments to this vendor (an id beginning 009).
Statusstatustext: Only return payments in this status.One of: APPROVING, SCHEDULED, PAID, CANCELLED, VOID, ESCHEATED.
Paid bydisbursement_typetext: Only return payments sent this way.One of: CHECK, ACH, RPPS, PAYPAL, OFFLINE, INTERNATIONAL_E_PAYMENT (International e payment), AMEX, VIRTUAL_CARD (Virtual card), WALLET, CREDIT_CARD (Credit card).
Processed on or afterprocess_date_on_or_afterdate: Only return payments processed on or after this date.
Processed on or beforeprocess_date_on_or_beforedate: Only return payments processed on or before this date.
Maximum resultsmax_resultsnumber: How many records to return on this page (1-100). BILL returns 20 when this is blank.From 1 to 100.
Pagepagetext: The 'Next page' value from an earlier run of this action. Leave blank for the first page.
Sort bysort_bytext: Which field to sort on. Leave blank for BILL's own order.One of: processDate, amount, createdTime, updatedTime.
Sort directionsort_directiontext: Which way to sort. Ascending unless you choose otherwise.One of: asc, desc.

Outputs

countnumber: How many payments this page carried.
next_pagetext: Cursor for the next page, or empty when this is the last one. Pass it back as 'Page'.
paymentslist: The payments that matched.
prev_pagetext: Cursor for the previous page, when there is one.
statustext: Status of the action execution ("success" on success).

Example output

{
  "count": 1,
  "next_page": "",
  "payments": [
    {
      "amount": 420.5,
      "disbursementType": "ACH",
      "id": "stp01ACMEPAYMENTREC1",
      "status": "PAID",
      "vendorId": "00901ACMEVENDORRECORD"
    }
  ],
  "prev_page": "",
  "status": "success"
}

List vendors

List the vendors on your BILL organization.

Inputs

Name starts withnametext: Only return vendors whose name starts with this.
Archived onlyarchivedtrue/false: On returns only archived records, off only active ones. Leave unset for both.
Account typeaccount_typetext: Only return records of this account type.One of: NONE, BUSINESS, PERSON.
Created on or aftercreated_on_or_afterdate: Only return records created on or after this date.
Updated on or afterupdated_on_or_afterdate: Only return records changed on or after this date.
Maximum resultsmax_resultsnumber: How many records to return on this page (1-100). BILL returns 20 when this is blank.From 1 to 100.
Pagepagetext: The 'Next page' value from an earlier run of this action. Leave blank for the first page.
Sort bysort_bytext: Which field to sort on. Leave blank for BILL's own order.One of: name, createdTime, updatedTime.
Sort directionsort_directiontext: Which way to sort. Ascending unless you choose otherwise.One of: asc, desc.

Outputs

countnumber: How many vendors this page carried.
next_pagetext: Cursor for the next page, or empty when this is the last one. Pass it back as 'Page'.
prev_pagetext: Cursor for the previous page, when there is one.
statustext: Status of the action execution ("success" on success).
total_countnumber: How many vendors matched in total, across all pages.
total_due_amountnumber: The total amount still due across everything matched.
vendorslist: The vendors that matched.

Example output

{
  "count": 1,
  "next_page": "",
  "prev_page": "",
  "status": "success",
  "total_count": 1,
  "total_due_amount": null,
  "vendors": [
    {
      "archived": false,
      "email": "ap@northwind.example",
      "id": "00901ACMEVENDORRECORD",
      "name": "Northwind Paper Co"
    }
  ]
}

Update a bill

Change a bill. Only the fields you fill in are changed. Line items can only be edited, not added: each one needs the id BILL gave it.

Inputs

Billbill_idtextRequired: The bill's BILL id, which begins 00n. Use 'List bills' to find one.
Vendorvendor_idtext: Move the bill to a different vendor (id begins 009).
Due datedue_datedate: A new due date for the bill.
Descriptiondescriptiontext: A new note about the bill.
Vendor invoice numberinvoice_numbertext: A corrected invoice number from the vendor.
Invoice dateinvoice_datedate: A corrected date on the vendor's invoice.
Payment termpayment_term_idtext: The payment term for this bill. Leave blank to keep the one it already has -- BILL requires a term on every update, so this step reads it back and sends it unchanged.
Purchase order numberpurchase_order_numbertext: A new PO number for this bill.
Line itemsline_itemslist: Existing lines to change. Each must carry the line's own id (beginning 'bli') from 'Get a bill'.

Outputs

billobject: The bill after the update.
bill_idtext: The bill that was updated.
statustext: Status of the action execution ("success" on success).
updated_fieldslist: The BILL fields this step changed.

Example output

{
  "bill": {
    "description": "September paper order",
    "dueDate": "2026-10-31",
    "id": "00n01ACMEBILLRECORD1"
  },
  "bill_id": "00n01ACMEBILLRECORD1",
  "status": "success",
  "updated_fields": [
    "description",
    "dueDate",
    "paymentTermId"
  ]
}

Update a customer

Change a customer's details. Only the fields you fill in are changed.

Inputs

Customercustomer_idtextRequired: The customer's BILL id, which begins 0cu. Use 'List customers' to find one.
Customer namenametext: A new name for the customer.
Emailemailtext: A new email address for invoices.
Company namecompany_nametext: The customer's company name, if it differs from the name.
Contact first namecontact_first_nametext: Given name of the person you deal with.
Contact last namecontact_last_nametext: Family name of the person you deal with.
Phonephonetext: The customer's phone number.
Faxfaxtext: The customer's fax number.
Descriptiondescriptiontext: A note about this customer, kept on their record.
Invoice currencyinvoice_currencytext: Three-letter currency code their invoices are issued in, such as USD, CAD, EUR or GBP.
Account typeaccount_typetext: Whether the customer is a business or a person.One of: NONE, BUSINESS, PERSON.
Payment termpayment_term_idtext: How long the customer has to pay an invoice. Sets the default term on their invoices.
Account numberaccount_numbertext: Your reference for this customer. It appears on invoices.
Billing address streetbilling_address_line1text: Street address.
Billing address street line 2billing_address_line2text: Suite, floor or unit.
Billing address citybilling_address_citytext: City or town.
Billing address state or provincebilling_address_state_or_provincetext: State, province or region.
Billing address postal codebilling_address_zip_or_postal_codetext: ZIP or postal code.
Billing address countrybilling_address_countrytext: Two-letter country code, such as US, CA or GB.

Outputs

customerobject: The customer after the update.
customer_idtext: The customer that was updated.
statustext: Status of the action execution ("success" on success).
updated_fieldslist: The BILL fields this step changed.

Example output

{
  "customer": {
    "companyName": "Harbour Design Ltd",
    "id": "0cu01ACMECUSTOMERREC",
    "name": "Harbour Design Studio"
  },
  "customer_id": "0cu01ACMECUSTOMERREC",
  "status": "success",
  "updated_fields": [
    "companyName"
  ]
}

Update a vendor

Change a vendor's details. Only the fields you fill in are changed.

Inputs

Vendorvendor_idtextRequired: The vendor's BILL id, which begins 009. Use 'List vendors' to find one; the id also appears in the vendor's BILL web address.
Vendor namenametext: A new name for the vendor.
Address streetaddress_line1text: Street address.
Address street line 2address_line2text: Suite, floor or unit.
Address cityaddress_citytext: City or town.
Address state or provinceaddress_state_or_provincetext: State, province or region.
Address postal codeaddress_zip_or_postal_codetext: ZIP or postal code.
Address countryaddress_countrytext: Two-letter country code, such as US, CA or GB.
Short nameshort_nametext: A shorter name for the vendor, used on lists and reports.
Your account numberaccount_numbertext: Your account number with this vendor -- the one on their billing statement.
Account typeaccount_typetext: Whether the vendor is a business or a person.One of: NONE, BUSINESS, PERSON.
Emailemailtext: The vendor's email address.
Phonephonetext: The vendor's phone number.
Bill currencybill_currencytext: Three-letter currency code their bills are issued in, such as USD, CAD, EUR or GBP.
Legal company namecompany_nametext: The vendor's registered company name, if it differs.
Tax IDtax_idtext: The vendor's tax identification number.
Tax ID typetax_id_typetext: Which kind of tax ID that is.One of: EIN, SSN.
Track for 1099track_1099true/false: Include this vendor's payments in 1099 reporting.
Payment lead time (days)lead_time_in_daysnumber: How many days ahead this vendor's payments must be sent.From 0 to 365.
Combine paymentscombine_paymentstrue/false: Pay several bills from this vendor in one payment.
Payment termpayment_term_idtext: The payment term to apply to this vendor's bills.

Outputs

statustext: Status of the action execution ("success" on success).
updated_fieldslist: The BILL fields this step changed.
vendorobject: The vendor after the update.
vendor_idtext: The vendor that was updated.

Example output

{
  "status": "success",
  "updated_fields": [
    "phone"
  ],
  "vendor": {
    "id": "00901ACMEVENDORRECORD",
    "name": "Northwind Paper Co",
    "phone": "415-555-0188"
  },
  "vendor_id": "00901ACMEVENDORRECORD"
}

ActionsCopy Anchor Link

Archive a vendorCopy Anchor Link

Inputs

Outputs

Create a billCopy Anchor Link

Inputs

Outputs

Create a customerCopy Anchor Link

Inputs

Outputs

Create a vendorCopy Anchor Link

Inputs

Outputs

Create an invoiceCopy Anchor Link

Inputs

Outputs

Get a billCopy Anchor Link

Inputs

Outputs

Get a customerCopy Anchor Link

Inputs

Outputs

Get a vendorCopy Anchor Link

Inputs

Outputs

Get an invoiceCopy Anchor Link

Inputs

Outputs

Get organizationCopy Anchor Link

Inputs

Outputs

Get session infoCopy Anchor Link

Inputs

Outputs

List billsCopy Anchor Link

Inputs

Outputs

List customersCopy Anchor Link

Inputs

Outputs

List invoicesCopy Anchor Link

Inputs

Outputs

List payment termsCopy Anchor Link

Inputs

Outputs

List paymentsCopy Anchor Link

Inputs

Outputs

List vendorsCopy Anchor Link

Inputs

Outputs

Update a billCopy Anchor Link

Inputs

Outputs

Update a customerCopy Anchor Link

Inputs

Outputs

Update a vendorCopy Anchor Link

Inputs

Outputs

On this page

Actions

Archive a vendor

Create a bill

Create a customer

Create a vendor

Create an invoice

Get a bill

Get a customer

Get a vendor

Get an invoice

Get organization

Get session info

List bills

List customers

List invoices

List payment terms

List payments

List vendors

Update a bill

Update a customer

Update a vendor