Skip to main content

Update Account Settings

PUT 
/api/admin/portal/accounts/:customer/settings

Update an account's payment term, minimum order value, discount, backorder policy, availability display, approval policy and catalog. Only supplied keys are changed.

Not yet available to API tokens

This endpoint currently requires session authentication; Personal Access Token scope support is in progress.

payment_term_id must reference an existing payment term; it is what drives invoice due dates. Send null to fall back to the account default.

credit_limit and credit_hold are NOT accepted here — they belong to the customer record and are set on the customer, so that one credit limit covers everything the customer owes. Sending them has no effect.

allow_backorder is a tri-state: null inherits the portal-wide default (see Update Portal Settings), true always allows backorders for this account, false never does. An individual product that sets its own backorder rule overrides both.

order_discount_tiers_json is the account's order-value discount ladder — [{"min_subtotal": 1000, "percent": 3}, {"min_subtotal": 5000, "percent": 5}] reads as "3% over 1,000, 5% over 5,000". At most 10 tiers; each threshold must be distinct and each percentage must exceed the one below it, or the write is rejected with 422. Send null to remove the ladder.

It is separate from discount_percent, which is a flat percentage off the tier/list price applied per line while pricing. The two compound: lines are priced with the flat discount, then the ladder applies to the resulting subtotal as an order-level discount on the created order.

Request​

Responses​

OK

Response Headers
    Content-Type