Update Customer
Update an existing customer's information. All fields are optional—only provided fields will be updated. Email uniqueness is enforced unless dangerouslyAllowSameEmailForDifferentCustomers is true. Cannot update merchantId or id.
Authorization
bearerAuth Use your secret API key as the bearer token
In: header
Path Parameters
Lumen customer ID (must start with cus_)
^cus_[a-z0-9]+$Request Body
application/json
Customer name
Customer email
emailCustomer phone number
Your application's user ID
Payment provider customer ID
Billing address line 1
Billing address line 2
Billing city
Billing state or province
Billing postal/ZIP code
Billing country (ISO 3166-1 alpha-2 code)
Business name
Tax ID / VAT number
Tax exemption status
Tax exemption reason
Tax exemption certificate URL
Manual tax rate definition ID
Tax calculation method
"auto" | "manual"Custom invoice prefix
length <= 20Language code
Timezone identifier
Currency code
Custom metadata
Bypass email uniqueness check
falseResponse Body
application/json
application/json
application/json
application/json
curl -X POST "https://api.getlumen.dev/v1/customers/cus_01hrwzqrz4ytkwv07syv8k7g3z" \ -H "Content-Type: application/json" \ -d '{ "name": "Jane Smith", "email": "jane.smith@example.com", "phoneNumber": "+19876543210" }'{
"customer": {
"id": "cus_01hrwzqrz4ytkwv07syv8k7g3z",
"merchantId": "mrc_01hptv3p6xj173pfv96pxd5pke",
"name": "Jane Smith",
"email": "jane.smith@example.com",
"phoneNumber": "+19876543210",
"externalCustomerId": "user_ext_abc123",
"pspCustomerId": "cus_stripe_abc123",
"billingAddressLine1": "456 Oak Avenue",
"billingAddressLine2": "Suite 200",
"billingCity": "Austin",
"billingStateProvince": "TX",
"billingPostalCode": "78701",
"billingCountry": "US",
"preferredCurrency": "USD",
"timezone": "America/Chicago",
"createdAt": "2024-12-01T10:00:00.000Z",
"updatedAt": "2025-02-20T16:30:45.128Z",
"deletedAt": null
}
}{
"error": "Customer not found or access denied"
}{
"error": "Another customer with this email already exists. Use dangerouslyAllowSameEmailForDifferentCustomers to allow."
}{
"error": "Failed to update customer",
"details": "Database connection error"
}