---
title: "Crea una solicitud"
method: POST
path: "/api/v1/solicitudes"
tags: ["Solicitudes"]
---

# Crea una solicitud

`POST /api/v1/solicitudes`

Crea una solicitud en la agencia con la información enviada y devuelve su información.

**Notas:**
- Debe indicarse un `email` o un `telefono` (al menos uno de los dos).
- La respuesta **200** devuelve la solicitud creada, incluida su `referencia`, que es el identificador a usar en las consultas posteriores (`GET /solicitudes/{referencia}`).
- La creación es visible de forma inmediata mediante GET (consistencia de lectura tras escritura).
- Puede crearse sin inmueble; para vincular inmuebles se envía la lista `inmuebles` con sus referencias.
- Para vincular una promoción se envía `promocion` con su referencia (la referencia de la promoción, no su id interno).
- Para vincular un cliente se envía `referenciaCliente` (la referencia del cliente, no su id interno).
- Los errores de validación devuelven **400** con el detalle por campo.
- No se aplica deduplicación: dos peticiones idénticas crean dos solicitudes distintas.



**Requisitos:**
- `solicitudes_create`

## Request body

- SolicitudCrearRequest — Datos necesarios para registrar una nueva solicitud de contacto o información. Además de los campos requeridos, debe indicarse un email o un teléfono (al menos uno de los dos).
  - `email` string, nullable — Correo electrónico del solicitante
  - `nombre` string, nullable, required — Nombre completo del solicitante
  - `telefono` string, nullable — Número de teléfono del solicitante
  - `mensaje` string, nullable — Mensaje o comentario enviado por el solicitante
  - `idCampana` integer, nullable — Id de la campaña
  - `tipoOperacion` 'Venta' | 'Alquiler' | 'Traspaso'
  - `estado` 'Sin_atender' | 'Atendido' | 'En_espera' | 'No_contesta' | 'Descartada' | 'Archivado' | 'Calificada_IA' | 'En_Proceso_IA' | 'Descartada_IA'
  - `tipoSolicitud` 'Llamada' | 'Email' | 'VisitaInmobiliaria' | 'Web' | 'Otros' | 'API', required
  - `idAgente` integer, nullable — Id del agente que hace la petición
  - `inmuebles` string[], nullable — Referencias de inmuebles a vincular: null = sin cambios; vacía = borra todas; con elementos = vincula las referencias.
  - `promocion` string, nullable — Referencia de la promoción a vincular: null = sin cambios; vacía = desvincula; con valor = vincula esa promoción.
  - `referenciaCliente` integer, nullable — Referencia del cliente a vincular
  - `poblacion` string, nullable — Poblacion de la solicitud
  - `zona` string, nullable — Zona de la solicitud
  - `precioMaximo` string, nullable — Precio máximo de la solicitud
  - `idioma` 'es' | 'ca' | 'de' | 'en' | 'eu' | 'fr' | 'gl' | 'it' | 'nl' | 'no' | 'pl' | 'pt' | 'ru' | 'sv' | 'uk'

## Response `200`

OK

- SolicitudResponseApiResponse
  - `datos` SolicitudResponse
    - `referencia` integer, nullable
    - `nombre` string, nullable
    - `email` string, nullable
    - `telefono` string, nullable
    - `mensaje` string, nullable
    - `fecha` string, date-time
    - `idAgente` integer, nullable
    - `idCampana` integer, nullable
    - `idCliente` integer, nullable
    - `referenciaCliente` integer, nullable
    - `poblacion` string, nullable
    - `precioMaximo` string, nullable
    - `zona` string, nullable
    - `estado` 'Sin_atender' | 'Atendido' | 'En_espera' | 'No_contesta' | 'Descartada' | 'Archivado' | 'Calificada_IA' | 'En_Proceso_IA' | 'Descartada_IA'
    - `tipoOperacion` 'Venta' | 'Alquiler' | 'Traspaso'
    - `tipoSolicitud` 'Llamada' | 'Email' | 'VisitaInmobiliaria' | 'Web' | 'Otros' | 'API'
    - `inmuebles` string[], nullable
    - `promocion` string, nullable
    - `idioma` 'es' | 'ca' | 'de' | 'en' | 'eu' | 'fr' | 'gl' | 'it' | 'nl' | 'no' | 'pl' | 'pt' | 'ru' | 'sv' | 'uk'

## 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/revisions/acbeb97ad5a7/schema)