Sign in

v1

latestOpenAPI 3.0.42026-08-064699207.1 KB
Clientes

Crea un cliente

Crea un cliente en la agencia con la información enviada y devuelve su información.

Notas:

  • El idAgente debe pertenecer a la agencia.
  • La respuesta 200 devuelve el cliente creado, incluida su referencia, que es el identificador a usar en las consultas posteriores (GET /clientes/{referencia}).
  • La creación es visible de forma inmediata mediante GET (consistencia de lectura tras escritura).
  • Se valida la unicidad dentro de la agencia de dni, email y los teléfonos: si ya existe un cliente con alguno de esos datos, la respuesta es 400 con el detalle del campo en conflicto.
  • También devuelven 400 una campaña, grupo, cuenta o agente que no pertenezca a la agencia.

Requisitos:

  • clientes_create
post/api/v1/clientes

Request body

dnistring nullable

Dni del cliente

nombrestring nullable required

Nombre completo del cliente

emailstring nullable

Correo electrónico del cliente

aliasstring nullable

Alias del cliente

direccionstring nullable

Dirección del cliente

codigoPostalstring nullable

Código postal del cliente

urlWebstring nullable

URL de la web del cliente

observacionesstring nullable

Observaciones del cliente

telefonoMovilstring nullable

Teléfono móvil 1 del cliente

telefono2string nullable

Teléfono 2 del cliente

telefono3string nullable

Teléfono 3 del cliente

idAgenteinteger required

Id del agente que hace la petición

estadoCivil'Soltero' | 'Casado' | 'Viudo' | 'Divorciado' | 'Separado' | 'ParejaDeHecho'
recibirAlertasEmailboolean nullable

Recibir alertas de email automáticas

recibirEmailManualesboolean nullable

Recibir alertas de email manuales

tipoPropietarioboolean nullable

Es propietario

tipoDemandanteboolean nullable

Es demandante

tipoClienteboolean nullable

Es cliente

tipoNewsletterboolean nullable

Es newsletter

idCampanainteger nullable

Id de la campaña

gruposinteger[] nullable

Lista de Ids de grupos para vincular al cliente

cuentasinteger[] nullable

Lista de Ids de cuentas para vincular al cliente

idsAgentesSincronizarinteger[] nullable

Lista de Ids de agentes para sincronizar el cliente con Google Contact

Response

OK