crisphive
ClientsCréer un client

Créer un client

Ajoute une nouvelle fiche client à l'entreprise courante. L'adresse (street, city, postal_code, ...) et les coordonnées (latitude/longitude) se trouvent sous l'objet imbriqué `address`. service_area_id doit être un UUID de zone de service valide appartenant à cette entreprise.

Arguments

addressobjectbodyoptionnel
Adresse postale et coordonnées.
citystringbodyoptionnel
countrystringbodyoptionnel
formattedstringbodyoptionnel
latitudenumberbodyoptionnel
linestringbodyoptionnel
line2stringbodyoptionnel
longitudenumberbodyoptionnel
postal_codestringbodyoptionnel
statestringbodyoptionnel
emailstringbodyoptionnel
Adresse e-mail. Facultative, mais au moins l'un des champs phone/email est requis.
full_namestringbodyrequis
Nom complet du client. Requis ; 255 caractères max.
phonestringbodyoptionnel
Numéro de téléphone. Facultatif, mais au moins l'un des champs phone/email est requis ; 10–20 caractères.
preferred_technician_idstringbodyoptionnel
UUID du technicien préféré de ce client. Doit appartenir à cette entreprise.
service_area_idstringbodyoptionnel
UUID de la zone de service de ce client. Doit appartenir à cette entreprise.
tierenumbodyoptionnel
Niveau de fidélité. Vaut "regular" par défaut si omis.
uidstringbodyoptionnel
Votre référence externe pour ce client (l'identifiant de votre propre système). Facultative ; 32 caractères max.
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"
}'
Corps de la requête
{
"address": {
"city": ,
"country": ,
"formatted": ,
"latitude": ,
"line": ,
"line2": ,
"longitude": ,
"postal_code": ,
"state":
},
"email": ,
"full_name": ,
"phone": ,
"preferred_technician_id": ,
"service_area_id": ,
"tier": ,
"uid":
}

Réponses