Update a customer
Updates a customer’s name, email, status, your own IDs, or the click and link the customer came from.
Authorizations
Tolt API key sent as a bearer token.
Path Parameters
"cus_LBfjvtfct9pVUeLojMHiGnXv"
Body
New email, stored lowercased and used as the customer's identifier. It must not belong to another customer.
1 - 255Resolve a code in the partner’s program, ignoring case, preferring partner, group, then program scope. An unmatched code leaves attribution unchanged. Null clears the promotion code and its derived attribution.
1When the customer was created, as a timestamp with a time zone, for example 2026-03-01T12:00:00Z. Reports and filters that date customers by creation use it; those that date them by conversion read active_at, which this does not change.
Customer's full name as you want it shown in the dashboard; it does not affect attribution or matching.
255Lifecycle stage of the customer. Changing it does not set active_at or run commission flows.
lead, active, canceled, suspended, trialing, null Customer's id in your billing system, such as a Stripe customer id. The billing integration matches payments to this customer by it.
1 - 255Customer's subscription id in your billing system, such as a Stripe subscription id.
255Id of the tracked click the customer came from, as returned when listing clicks. It must belong to the customer's partner; link_id is not changed.
Id of the referral link the customer came through (lnk_...). It must belong to the customer's partner; a customer without a partner takes the link's partner and program.
When the customer signed up as a lead, as a timestamp with a time zone, for example 2026-03-01T12:00:00Z.
When the customer became a paying customer, as a timestamp with a time zone.

