Customers›Update a customer
Update a customer
Replaces mutable fields on a customer record — two-way CRM sync friendly (push changes from your system of record). Pass service_area_id="" to clear the service area. Address fields (including latitude/longitude) live under the nested `address` object.
Arguments
idstringpathrequired
Customer ID (UUID)
▾addressobjectbodyoptional
Postal address and coordinates.
emailstringbodyoptional
Email address.
full_namestringbodyrequired
Customer's full name. Required; max 255 chars.
notesstringbodyoptional
Free-form internal notes about the customer; max 4000 chars.
phonestringbodyoptional
Phone number. 10–20 chars.
preferred_technician_idstringbodyoptional
UUID of the technician this customer prefers. Must belong to this business.
service_area_idstringbodyoptional
UUID of the service area for this customer. Must belong to this business.
statusenumbodyoptional
Lifecycle status.
tierenumbodyoptional
Loyalty tier.
uidstringbodyoptional
Your external reference for this customer. Optional; max 32 chars.
PUT/v1/customers/{id}
curl -X PUT "https://api.crisphive.com/v1/customers/9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01" \ -H "Authorization: Bearer chsk_test_4eC8xQ9mZ2pL7Ka0rT" \ -H "Content-Type: application/json" \ -d '{ "address": { "city": "San Francisco", "country": "US", "formatted": "123 Market Street, San Francisco, CA 94103", "latitude": 1, "line": "123 Market Street", "line2": "Suite 200", "longitude": 1, "postal_code": "94103", "state": "CA" }, "email": "jane.doe@example.com", "full_name": "Jane Cooper", "notes": "Please call on arrival.", "phone": "+14155550142", "preferred_technician_id": "9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01", "service_area_id": "9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01", "status": "active", "tier": "regular", "uid": "CRM-10293" }'
Request body
{
"address": {
"city": ,
"country": ,
"formatted": ,
"latitude": ,
"line": ,
"line2": ,
"longitude": ,
"postal_code": ,
"state":
},
"email": ,
"full_name": ,
"notes": ,
"phone": ,
"preferred_technician_id": ,
"service_area_id": ,
"status": ,
"tier": ,
"uid":
}
Bearer