Customers›Create a customer
Create a customer
Creates a customer record — the client/account profile a job request (work order) is booked against; use it to import or sync customers from your own CRM, website lead form or intake flow. Address (street, city, postal_code, ...) and coordinates (latitude/longitude) live under the nested `address` object. service_area_id must be a valid service area UUID belonging to this business.
Arguments
▾addressobjectbodyoptional
Postal address and coordinates.
emailstringbodyoptional
Email address. Optional, but at least one of phone/email is required.
full_namestringbodyrequired
Customer's full name. Required; max 255 chars.
phonestringbodyoptional
Phone number. Optional, but at least one of phone/email is required; 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.
tierenumbodyoptional
Loyalty tier. Defaults to "regular" if omitted.
uidstringbodyoptional
Your external reference for this customer (your own system's ID). Optional; max 32 chars.
POST/v1/customers
curl -X POST "https://api.crisphive.com/v1/customers" \ -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", "phone": "+14155550142", "preferred_technician_id": "9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01", "service_area_id": "9b2f6c3e-1a4d-4f0a-8f2e-7c5d1b3a9e01", "tier": "regular", "uid": "CRM-10293" }'
Request body
{
"address": {
"city": ,
"country": ,
"formatted": ,
"latitude": ,
"line": ,
"line2": ,
"longitude": ,
"postal_code": ,
"state":
},
"email": ,
"full_name": ,
"phone": ,
"preferred_technician_id": ,
"service_area_id": ,
"tier": ,
"uid":
}
Bearer