crisphive
ClientesCrear un cliente

Crear un cliente

Añade un nuevo registro de cliente al negocio actual. La dirección (street, city, postal_code, ...) y las coordenadas (latitude/longitude) van dentro del objeto anidado `address`. service_area_id debe ser un UUID de un área de servicio válida perteneciente a este negocio.

Argumentos

addressobjectbodyopcional
Dirección postal y coordenadas.
citystringbodyopcional
countrystringbodyopcional
formattedstringbodyopcional
latitudenumberbodyopcional
linestringbodyopcional
line2stringbodyopcional
longitudenumberbodyopcional
postal_codestringbodyopcional
statestringbodyopcional
emailstringbodyopcional
Dirección de correo electrónico. Opcional, pero se requiere al menos uno de phone/email.
full_namestringbodyobligatorio
Nombre completo del cliente. Obligatorio; máx. 255 caracteres.
phonestringbodyopcional
Número de teléfono. Opcional, pero se requiere al menos uno de phone/email; 10–20 caracteres.
preferred_technician_idstringbodyopcional
UUID del técnico que prefiere este cliente. Debe pertenecer a este negocio.
service_area_idstringbodyopcional
UUID del área de servicio de este cliente. Debe pertenecer a este negocio.
tierenumbodyopcional
Nivel de fidelidad. Por defecto "regular" si se omite.
uidstringbodyopcional
Su referencia externa para este cliente (el ID de su propio sistema). Opcional; máx. 32 caracteres.
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"
}'
Cuerpo de la solicitud
{
"address": {
"city": ,
"country": ,
"formatted": ,
"latitude": ,
"line": ,
"line2": ,
"longitude": ,
"postal_code": ,
"state":
},
"email": ,
"full_name": ,
"phone": ,
"preferred_technician_id": ,
"service_area_id": ,
"tier": ,
"uid":
}

Respuestas