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

# Crea una solicitud

`POST /api/v1/solicitudes`

## Request

- Base URL: `https://api.mobiliagestion.es` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mobiliagestion.es/api/v1/solicitudes`
- Auth: API key in header `Authorization`

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).
- `idioma` indica el idioma en el que se responde al solicitante (email de cortesía). Si no se indica, se usa el del cliente vinculado y, si tampoco lo hay, el español.
- 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' | 'MetaAds', 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
    - `observaciones` 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' | 'MetaAds'
    - `inmuebles` string[], nullable
    - `inmueblesPersonalizados` InmuebleReferencias[], nullable
      - `referencia` string, nullable
      - `referenciaPersonalizada` 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

## Changes

- **2026-11-06** `d893803b00d5`: 1 info
  - added the optional property `datos/inmueblesPersonalizados` to the response with the `200` status
- **2026-10-23** `bb4b9d91fad8`: 1 warning, 5 info
  - added the new `MetaAds` enum value to the `datos/tipoSolicitud` response property for the response status `200`
  - added the new `MetaAds` enum value to the request property `tipoSolicitud` (media type: application/json-patch+json)
  - added the new `MetaAds` enum value to the request property `tipoSolicitud` (media type: application/json)
  - added the new `MetaAds` enum value to the request property `tipoSolicitud` (media type: text/json)
  - …2 more

[Operation history](https://skmtc.dev/mobiliagestion/apis/mobilia-public-api/changes/api/v1/solicitudes/post.md)

---

[API](https://skmtc.dev/mobiliagestion/apis/mobilia-public-api.md) - [All operations](https://skmtc.dev/mobiliagestion/apis/mobilia-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/mobiliagestion/apis/mobilia-public-api/revisions/d893803b00d5?raw)