SoftSolzSoftSolz
HomeAPI GuideAPI ReferenceWidget Tester
invoicing

Update a customer.

Update a customer.

PUThttps://staging.softsolz.uk/api/v1/services/invoicing/customers/{id}

Recent Requests

Log in to see full request history
TimeStatusUser Agent
Make a request to see history.

Path Params

idstringrequired

Headers

Authorizationstringrequired

Bearer token: `Bearer sk_live_...` (or `sk_test_...` for sandbox). A login token will not work here.

Body Params

display_namestring

Customer display name (required, trimmed).

emailstring | null

Primary AR email (lower-cased).

phonestring | null

Contact phone.

billing_address_line1string | null

Billing address line 1.

billing_citystring | null

Billing city.

billing_postal_codestring | null

Billing postal code.

billing_countrystring | null

Billing country (ISO 2-letter).

tax_idstring | null

Tax / VAT id.

default_payment_terms_daysinteger

Default payment terms in days (default 30).

default_currencystring

3-letter currency code; defaults to USD.

notesstring | null

Free-text notes.

expected_updated_atstring

Optimistic-concurrency guard; if stale, returns 409 STALE_VERSION.

Response

Response Body

idintegerCustomer id.
display_namestringCustomer display name.
emailstring | nullPrimary AR email.
phonestring | nullContact phone.
billing_address_line1string | nullBilling address line 1.
billing_citystring | nullBilling city.
billing_postal_codestring | nullBilling postal code.
billing_countrystring | nullBilling country (ISO 2-letter).
tax_idstring | nullTax / VAT id.
default_payment_terms_daysintegerDefault payment terms in days.
default_currencystringDefault ISO 4217 currency code.
is_activebooleanFalse once archived.
created_atstringCreation timestamp.
updated_atstringLast update timestamp; round-trip as expected_updated_at.

Request

import { SoftSolz } from '@softsolz/sdk';
const client = new SoftSolz({ apiKey: process.env.SOFTSOLZ_API_KEY });
const result = await client.invoicing.updateCustomer('<id>', {});
console.log(result);

Credentials

Sent as a Bearer token. Stored only in your browser.

Response · 200

{
"data": {
"id": 0,
"display_name": "string",
"email": "string",
"phone": "string",
"billing_address_line1": "string",
"billing_city": "string",
"billing_postal_code": "string",
"billing_country": "string",
"tax_id": "string",
"default_payment_terms_days": 0,
"default_currency": "string",
"is_active": true,
"created_at": "string",
"updated_at": "string"
}
}