BIbill
customers

Create a customer

Changed on

Create a new customer.

See Customers in the Guides section for more information, sample requests, and responses.

post/v3/customers

Request

  • Base URL
    https://gateway.stage.bill.com/connect
  • URL
    https://gateway.stage.bill.com/connect/v3/customers
  • Auth
    none declared

Headers

sessionIdstring nullable

API session ID generated with /v3/login

Example:{{session_id}}
devKeystring nullable

Developer key generated with your BILL developer account

Example:{{developer_key}}

Request body

namestring required

Customer name

companyNamestring

Customer company name

emailstring required

Customer email address

phonestring

Customer phone number

faxstring

Customer fax number

descriptionstring

Customer description

invoiceCurrency'AED' | 'AFN' | 'ALL' | 'AMD' | 'ANG' | 'AOA' | 'ARS' | 'AUD' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BGN' | 'BHD' | 'BIF' | 'BMD' | 'BND' | 'BOB' | 'BRL' | 'BSD' | 'BTN' | 'BWP' | 'BYN' | 'BZD' | 'CAD' | 'CDF' | 'CHF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CUC' | 'CUP' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EGP' | 'ERN' | 'ETB' | 'EUR' | 'FJD' | 'FKP' | 'GBP' | 'GEL' | 'GGP' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HRK' | 'HTG' | 'HUF' | 'IDR' | 'ILS' | 'IMP' | 'INR' | 'IQD' | 'IRR' | 'ISK' | 'JEP' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KMF' | 'KPW' | 'KRW' | 'KWD' | 'KYD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MNT' | 'MOP' | 'MRU' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SDG' | 'SEK' | 'SGD' | 'SHP' | 'SLE' | 'SLL' | 'SOS' | 'SPL' | 'SRD' | 'STN' | 'SVC' | 'SYP' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TVD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'USD' | 'UYU' | 'UZS' | 'VEF' | 'VND' | 'VUV' | 'WST' | 'XAF' | 'XCD' | 'XDR' | 'XOF' | 'XPF' | 'YER' | 'ZAR' | 'ZMW' | 'ZWD'

Invoice currency. Three-letter abbreviation.

accountType'NONE' | 'BUSINESS' | 'PERSON'

Customer account type

paymentTermIdstring

BILL-generated ID of the payment term. Use payment terms to set the number of days the customer has to clear an invoice.

accountNumberstring

Customer account number. The number appears in customer invoices.

Example request

{
  "name": "Paperless Band",
  "companyName": "Paperless Band LLC",
  "contact": {
    "firstName": "Check",
    "lastName": "Mailworth"
  },
  "email": "contact@paperlessband.org",
  "accountType": "BUSINESS",
  "phone": "9998887654",
  "billingAddress": {
    "line1": "987 Side Street",
    "city": "San Jose",
    "stateOrProvince": "CA",
    "zipOrPostalCode": "95002",
    "country": "US"
  }
}

Response

Create a customer response

idstring

BILL-generated ID of the customer. The value begins with 0cu.

archivedboolean

Set as true if the customer is archived.

namestring required

Customer name

companyNamestring

Customer company name. This field is overridden when you connect with a customer in the BILL network.

emailstring required

Customer email address

phonestring

Customer phone number. This field is overridden when you connect with a customer in the BILL network.

faxstring

Customer fax number

descriptionstring

Customer description

invoiceCurrency'AED' | 'AFN' | 'ALL' | 'AMD' | 'ANG' | 'AOA' | 'ARS' | 'AUD' | 'AWG' | 'AZN' | 'BAM' | 'BBD' | 'BDT' | 'BGN' | 'BHD' | 'BIF' | 'BMD' | 'BND' | 'BOB' | 'BRL' | 'BSD' | 'BTN' | 'BWP' | 'BYN' | 'BZD' | 'CAD' | 'CDF' | 'CHF' | 'CLP' | 'CNY' | 'COP' | 'CRC' | 'CUC' | 'CUP' | 'CVE' | 'CZK' | 'DJF' | 'DKK' | 'DOP' | 'DZD' | 'EGP' | 'ERN' | 'ETB' | 'EUR' | 'FJD' | 'FKP' | 'GBP' | 'GEL' | 'GGP' | 'GHS' | 'GIP' | 'GMD' | 'GNF' | 'GTQ' | 'GYD' | 'HKD' | 'HNL' | 'HRK' | 'HTG' | 'HUF' | 'IDR' | 'ILS' | 'IMP' | 'INR' | 'IQD' | 'IRR' | 'ISK' | 'JEP' | 'JMD' | 'JOD' | 'JPY' | 'KES' | 'KGS' | 'KHR' | 'KMF' | 'KPW' | 'KRW' | 'KWD' | 'KYD' | 'KZT' | 'LAK' | 'LBP' | 'LKR' | 'LRD' | 'LSL' | 'LYD' | 'MAD' | 'MDL' | 'MGA' | 'MKD' | 'MMK' | 'MNT' | 'MOP' | 'MRU' | 'MUR' | 'MVR' | 'MWK' | 'MXN' | 'MYR' | 'MZN' | 'NAD' | 'NGN' | 'NIO' | 'NOK' | 'NPR' | 'NZD' | 'OMR' | 'PAB' | 'PEN' | 'PGK' | 'PHP' | 'PKR' | 'PLN' | 'PYG' | 'QAR' | 'RON' | 'RSD' | 'RUB' | 'RWF' | 'SAR' | 'SBD' | 'SCR' | 'SDG' | 'SEK' | 'SGD' | 'SHP' | 'SLE' | 'SLL' | 'SOS' | 'SPL' | 'SRD' | 'STN' | 'SVC' | 'SYP' | 'SZL' | 'THB' | 'TJS' | 'TMT' | 'TND' | 'TOP' | 'TRY' | 'TTD' | 'TVD' | 'TWD' | 'TZS' | 'UAH' | 'UGX' | 'USD' | 'UYU' | 'UZS' | 'VEF' | 'VND' | 'VUV' | 'WST' | 'XAF' | 'XCD' | 'XDR' | 'XOF' | 'XPF' | 'YER' | 'ZAR' | 'ZMW' | 'ZWD'

Invoice currency. Three-letter abbreviation.

accountType'NONE' | 'BUSINESS' | 'PERSON' | 'UNDEFINED'

Customer account type

paymentTermIdstring

BILL-generated ID of the payment term. Use payment terms to set the number of days the customer has to clear an invoice.

accountNumberstring

Customer account number. The number appears in customer invoices.

hasBankAccountboolean

Set as true if the customer bank account is added

authorizedToChargeboolean

Set as true if your organization is authorized to charge the customer for invoices

createdTimestring date-time

Created date and time

updatedTimestring date-time

Updated date and time

relevanceScorenumber double

Relevance score from the fuzzy name search that matched this customer. This field appears in the response only for customers matched by an fz filter on name.

Scores are comparable only among the results of a single search. Do not compare them across searches or against a fixed threshold.

Changes

  • 54edddceb0a5Revision changes
    • breaking

      added subschema #2 to the ///// request property allOf list

    • breaking

      added subschema #2 to the ///// request property allOf list

    • breaking

      the request property ///// became required

    • breaking

      the request property ///// became required

    • breaking

      the request property ///// became required

    • breaking

      the request property ///// became required

    • breaking

      the request property ///// became required

    • breaking

      the request property ///// became required

    • breaking

      the request property ///// became required

    • breaking

      the request property ///// became required

    • breaking

      the ///// request property's minLength was increased from 0 to 1

    • breaking

      the ///// request property's minLength was increased from 0 to 1

    • breaking

      the ///// request property's minLength was increased from 0 to 1

    • breaking

      the ///// request property's minLength was increased from 0 to 1

    • breaking

      the ///// request property's minLength was increased from 0 to 1

    • breaking

      the ///// request property's minLength was increased from 0 to 1

    • breaking

      added the pattern ^.{0,1000}$ to the request property /////

    • breaking

      added the pattern ^.{0,1000}$ to the request property /////

    • breaking

      added the pattern ^.{0,100}$ to the request property /////

    • breaking

      added the pattern ^.{0,100}$ to the request property /////

    • breaking

      added the pattern ^.{0,100}$ to the request property /////

    • breaking

      added the pattern ^.{0,100}$ to the request property /////

    • breaking

      added the pattern ^.{0,100}$ to the request property /////

    • breaking

      added the pattern ^.{0,100}$ to the request property /////

    • breaking

      added the pattern ^.{0,30}$ to the request property /////

    • breaking

      added the pattern ^.{0,30}$ to the request property /////

    • breaking

      the ///// request property type changed from string to no type

    • breaking

      the ///// request property type changed from string to no type

    • info

      added the optional property to the response with the status