Kunden›Kunden anlegen
Kunden anlegen
Fügt dem aktuellen Unternehmen einen neuen Kundendatensatz hinzu. Adresse (street, city, postal_code, ...) und Koordinaten (latitude/longitude) befinden sich im verschachtelten `address`-Objekt. service_area_id muss eine gültige Servicegebiet-UUID sein, die zu diesem Unternehmen gehört.
Argumente
▾addressobjectbodyoptional
Postanschrift und Koordinaten.
emailstringbodyoptional
E-Mail-Adresse. Optional, aber mindestens eines von phone/email ist erforderlich.
full_namestringbodyerforderlich
Vollständiger Name des Kunden. Erforderlich; max. 255 Zeichen.
phonestringbodyoptional
Telefonnummer. Optional, aber mindestens eines von phone/email ist erforderlich; 10–20 Zeichen.
preferred_technician_idstringbodyoptional
UUID des Technikers, den dieser Kunde bevorzugt. Muss zu diesem Unternehmen gehören.
service_area_idstringbodyoptional
UUID des Servicegebiets für diesen Kunden. Muss zu diesem Unternehmen gehören.
tierenumbodyoptional
Treuestufe. Standardwert ist "regular", falls nicht angegeben.
uidstringbodyoptional
Ihre externe Referenz für diesen Kunden (die ID Ihres eigenen Systems). Optional; max. 32 Zeichen.
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" }'
Anfragetext
{
"address": {
"city": ,
"country": ,
"formatted": ,
"latitude": ,
"line": ,
"line2": ,
"longitude": ,
"postal_code": ,
"state":
},
"email": ,
"full_name": ,
"phone": ,
"preferred_technician_id": ,
"service_area_id": ,
"tier": ,
"uid":
}
Bearer