Public API

Inicio rápido

La API usa JSON sobre HTTPS. Primero intercambia tus credenciales por un JWT y úsalo como Bearer token en las peticiones posteriores.

Cada credencial está vinculada a una inmobiliaria. InmoCMS selecciona automáticamente su base de datos; nunca debes enviar identificadores de base de datos.

Autenticación

curl -X POST "https://api-public.inmocms.com/api/v1/auth/token" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "client_id": "inm_xxxxxxxxxxxxxxxxxxxxxxxx",
    "client_secret": "sec_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }'

{
  "access_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  "token_type": "Bearer",
  "expires_in": 3600
}

Alta de clientes

Cabeceras

Campos comunes

Se aplican tanto a demandantes como a ofertantes. Debes enviar al menos uno de telefono o email; puedes enviar ambos.

Los campos obligatorios no pueden omitirse ni enviarse como null o texto vacío. Los campos opcionales pueden omitirse o enviarse como null. Si se envía un valor, debe cumplir el tipo y los límites indicados. Los números se muestran con punto decimal en JSON.

Demandante

Envía los campos comunes con tipo_cliente: "demandante" y los siguientes campos específicos en la raíz del JSON.

Ejemplo de petición

curl -X POST "https://api-public.inmocms.com/api/v1/clientes" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: whatsapp-982371" \
  -d '{
    "tipo_cliente": "demandante",
    "nombre": "Ana García",
    "telefono": "+34600111222",
    "email": "ana@example.com",
    "zonas_interes": ["Centro", "Chamberí"],
    "presupuesto_orientativo": 350000,
    "referencia_piso": "REF-2026-104",
    "origen": "WhatsApp"
  }'

Ofertante

Envía los campos comunes con tipo_cliente: "ofertante" y el objeto inmueble. Los campos con prefijo inmueble. van dentro de ese objeto.

Ejemplo de petición

curl -X POST "https://api-public.inmocms.com/api/v1/clientes" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: portal-445901" \
  -d '{
    "tipo_cliente": "ofertante",
    "nombre": "Carlos Pérez",
    "telefono": "+34600999888",
    "email": "carlos@example.com",
    "origen": "Email",
    "inmueble": {
      "direccion_zona": "Calle Mayor 10, Madrid",
      "tipo_operacion": "venta",
      "tipo_inmueble": "piso",
      "metros_cuadrados": 92,
      "habitaciones": 3,
      "banos": 2,
      "precio_orientativo": 420000,
      "estado_descripcion": "Reformado, exterior"
    }
  }'

Respuesta 201

{
  "message": "Cliente creado correctamente.",
  "data": {
    "lead_id": 81,
    "cliente_id": 1254,
    "inmueble_id": 908,
    "tipo_cliente": "ofertante",
    "created_at": "2026-09-18T10:30:00+02:00"
  }
}

Errores y límites

Se permiten 14 peticiones por minuto y credencial. El intento 15 bloquea la credencial durante 60 segundos. Consulta Retry-After antes de reintentar.