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

Updates a customer

Changed on Nov 3, 2026

Updates a single customer record in the catalog. IMPORTANT: This is a full-replace operation (PUT semantics). All fields must be included in the request body — omitting any field will set it to null, wiping existing data. Always call retrieve-a-customer first to fetch the current record, then include ALL existing fields in your update request along with your changes. Exceptions that keep stored data when the field is omitted:

metadata: omit it to keep all existing metadata, or send only the keys you want to set or clear.
addresses: omit address and billing_addresses to keep the stored billing addresses, and likewise shipping_address and shipping_addresses. This is for backward compatibility: integrations built before customers could have several addresses won't wipe the ones they don't send.

put/customers/{customer_id}

Request

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

Path parameters

customer_idstring required

UUID of the customer to be used in this operation.

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.

metadataInlineMetadataValues

Partial metadata update keyed by definition key. Omitting this property preserves all existing metadata. When supplied, omitted keys remain unchanged; null, empty, or whitespace-only values clear only the named key.

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.