Crisphive
fr
Clients›Créer un client

Créer un client

Crée une fiche client — le profil client/compte auquel une demande d'intervention (ordre de travail) est rattachée lors de la réservation ; utilisez-la pour importer ou synchroniser des clients depuis votre propre CRM, un formulaire de contact de votre site web ou votre parcours d'admission. 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

Idempotency-Keystringheaderoptionnel
Unique key making retries safe: a repeat send with the same key replays the original response (header Idempotent-Replayed: true) instead of re-running the operation. Reusing a key with a different body returns 422 IDEMPOTENCY_KEY_REUSE.
▾addressobjectbodyoptionnel
Adresse postale et coordonnées.
citystringbodyoptionnel
City / locality. Max 100 chars.
countrystringbodyoptionnel
Country (free-form or ISO code). Max 100 chars.
formattedstringbodyoptionnel
Human-readable single-line address; when set it wins over the discrete parts for display. Max 500 chars.
latitudenumberbodyoptionnel
Geographic latitude in decimal degrees (-90..90). Omit if unknown.
linestringbodyoptionnel
Street address, line 1 (e.g. "123 Main St"). Max 255 chars.
line2stringbodyoptionnel
Street address, line 2 (apartment, suite, unit). Max 255 chars.
longitudenumberbodyoptionnel
Geographic longitude in decimal degrees (-180..180). Omit if unknown.
postal_codestringbodyoptionnel
Postal / ZIP code. Max 32 chars.
statestringbodyoptionnel
State / province / region. Max 100 chars.
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.
sms_opt_inbooleanbodyoptionnel
SMS consent: set true ONLY when the customer explicitly agreed to receive SMS (e.g. ticked a non-pre-checked consent box, or gave verbal/written consent you keep a record of). SMS notifications are suppressed while false.
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",
  "sms_opt_in": true,
  "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": ,
"sms_opt_in": ,
"tier": ,
"uid":
}

Réponses

‹Lister les clientsPrécédent
Supprimer un client›Suivant