Update a customer
Updates contact fields, addresses, or metadata. All body fields are
optional; only those present are changed. Pass null explicitly for
billing_address or shipping to remove the address. Updating a
deleted customer returns 422.
Authorizations
A merchant secret key (sk_…) sent as Authorization: Bearer <key>.
Headers
A unique key that makes retries safe: the same key with the same request body returns the original response instead of repeating the operation.
255Path Parameters
The customer id (cus_…).
Body
All fields are optional. Only fields present in the body are changed. Pass null for billing_address or shipping to clear the address.
New email address. Must be unique per merchant and mode.
Updated billing address, or null to clear.
Updated shipping details, or null to clear.
Replaces the customer's metadata map in full.
Response
The updated customer.
Unique customer identifier (cus_…).
customer Whether this customer was created with a live (true) or test (false) key.
Empty string when not set.
Empty string when not set.
Empty string when not set.
Billing address; null when not set.
Shipping details; null when not set.
How the customer was created (for example api).
api, checkout, import, dashboard, platform Payment configuration stored for the customer.
True when the customer has been soft-deleted.
Unix epoch seconds.

