API Key1

Approval Workflow Models5

Approval Workflows3

Bank accounts5

Bank Transactions5

Bill Payments3

Bills10

Books1

Books periods5

Cash Matching3

Charges5

Chart of Accounts7

Close Checklist4

Contract Documents3

Contract Items3

Contracts15

Credit Memos8

Customer Families8

Customer Payments2

Customers9

Draft Contract Documents3

Draft Contracts5

External Reference Types1

Feedback1

Fields6

Health1

Invoice Documents3

Invoice payments5

Invoices12

Journal Entries5

Journal Entry Documents2

Members1

Metadata1

Organizations1

Products6

Reimbursement Payments3

Reimbursements5

Reports7

Roles2

Subsidiaries2

Tax rates1

Vendor Credit Applications1

Vendor Credits5

Vendors5

Webhooks

Webhooks23

Customers

Creates a customer

Changed on Nov 3, 2026

Creates a new customer in the Accounts Receivable catalog. Required fields: name. When providing a billing or shipping address, line1, city, zip_code, and country are required. State is required for United States addresses (use a 2-letter code such as 'TN' or 'CA') and may be omitted where it does not apply.

post/customers

Request

Base URL
https://api.rillet.com
Auth
HTTP bearer
TypeScript
https://skmtc.dev/rillet/apis/rillet-accounting-api/docs/customers/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

namestring required

name_on_invoicestring

payment_termsinteger

send_invoices_automaticallyboolean

When set to true, invoices for this customer will be automatically sent via email on the invoice date.

send_payment_remindersboolean

When set to true, an email will be sent to customers periodically if they have not paid an invoice.

allow_online_paymentsboolean

Allows this customer to pay invoices online via Stripe, and must be true before auto-payment can be set up for them. Omit on create to leave online payments off; omit on update to keep the customer's current setting. Enabling it requires Stripe to be configured for at least one subsidiary.

Example request

{
  "name": "Bob",
  "name_on_invoice": "Bob Johnson",
  "address": {
    "line1": "123 Main St",
    "line2": "Apt 4B",
    "city": "Nashville",
    "state": "TN",
    "zip_code": "37201",
    "country": "US"
  },
  "shipping_address": {
    "line1": "123 Main St",
    "line2": "Apt 4B",
    "city": "Nashville",
    "state": "TN",
    "zip_code": "37201",
    "country": "US"
  },
  "billing_addresses": [
    {
      "line1": "123 Main St",
      "line2": "Apt 4B",
      "city": "Nashville",
      "state": "TN",
      "zip_code": "37201",
      "country": "US"
    }
  ],
  "shipping_addresses": [
    {
      "line1": "123 Main St",
      "line2": "Apt 4B",
      "city": "Nashville",
      "state": "TN",
      "zip_code": "37201",
      "country": "US"
    }
  ],
  "emails": [
    {
      "id": "0193a6f2-4c1e-7b8a-9d3f-2e5c8a1b7f40",
      "email": "bobjohnson@somedomain.com"
    }
  ],
  "external_references": [
    {
      "type": "xyzSystemId",
      "id": "234",
      "url": "https://xyzsystempage.com/ids/234"
    }
  ],
  "tax_ids": [
    {
      "value": "DE123456789"
    }
  ]
}

Response

idstring uuid required

updated_atstring date-time required

ISO 8601 timestamp in UTC timezone (must end with 'Z')

metadataobject

Customer metadata values keyed by metadata definition key.

family_idstring uuid nullable

The family this customer belongs to. Set through the customer-families endpoints, not here.

parent_customer_idstring uuid nullable

The member this customer reports to within its family. The family's root parent reports to no one.