---
title: "Crea un cliente"
method: POST
path: "/api/v1/clientes"
tags: ["Clientes"]
---

# Crea un cliente

`POST /api/v1/clientes`

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`

## Request body

- ClienteCrearRequest
  - `dni` string, nullable — Dni del cliente
  - `nombre` string, nullable, required — Nombre completo del cliente
  - `email` string, nullable — Correo electrónico del cliente
  - `alias` string, nullable — Alias del cliente
  - `direccion` string, nullable — Dirección del cliente
  - `codigoPostal` string, nullable — Código postal del cliente
  - `urlWeb` string, nullable — URL de la web del cliente
  - `observaciones` string, nullable — Observaciones del cliente
  - `telefonoMovil` string, nullable — Teléfono móvil 1 del cliente
  - `telefono2` string, nullable — Teléfono 2 del cliente
  - `telefono3` string, nullable — Teléfono 3 del cliente
  - `idAgente` integer, required — Id del agente que hace la petición
  - `estadoCivil` 'Soltero' | 'Casado' | 'Viudo' | 'Divorciado' | 'Separado' | 'ParejaDeHecho'
  - `recibirAlertasEmail` boolean, nullable — Recibir alertas de email automáticas
  - `recibirEmailManuales` boolean, nullable — Recibir alertas de email manuales
  - `tipoPropietario` boolean, nullable — Es propietario
  - `tipoDemandante` boolean, nullable — Es demandante
  - `tipoCliente` boolean, nullable — Es cliente
  - `tipoNewsletter` boolean, nullable — Es newsletter
  - `idCampana` integer, nullable — Id de la campaña
  - `grupos` integer[], nullable — Lista de Ids de grupos para vincular al cliente
  - `cuentas` integer[], nullable — Lista de Ids de cuentas para vincular al cliente
  - `idsAgentesSincronizar` integer[], nullable — Lista de Ids de agentes para sincronizar el cliente con Google Contact

## Response `200`

OK

- ClienteResponseApiResponse
  - `datos` ClienteResponse
    - `idCliente` integer, nullable
    - `referencia` integer, nullable
    - `dni` string, nullable
    - `nombre` string, nullable
    - `email` string, nullable
    - `alias` string, nullable
    - `direccion` string, nullable
    - `codigoPostal` string, nullable
    - `urlWeb` string, nullable
    - `observaciones` string, nullable
    - `telefonoMovil` string, nullable
    - `telefono2` string, nullable
    - `telefono3` string, nullable
    - `estadoCivil` 'Soltero' | 'Casado' | 'Viudo' | 'Divorciado' | 'Separado' | 'ParejaDeHecho'
    - `idiomaComunicacion` string, nullable
    - `idAgenteCrea` integer, nullable
    - `idAgenteModifica` integer, nullable
    - `recibirAlertasEmail` boolean, nullable
    - `recibirEmailManuales` boolean, nullable
    - `propietario` boolean, nullable
    - `demandante` boolean, nullable
    - `tipoCliente` boolean, nullable
    - `tipoNewsletter` boolean, nullable
    - `idCampana` integer, nullable
    - `fechaUltimoContacto` string, date-time, nullable
    - `fechaAlta` string, date-time, nullable
    - `grupos` integer[], nullable
    - `cuentas` integer[], nullable

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/mobiliagestion/apis/mobilia-public-api.md) · [All operations](https://skmtc.net/mobiliagestion/apis/mobilia-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mobiliagestion/mobilia-public-api/versions/acbeb97ad5a7/schema)