---
title: "Crea una visita"
method: POST
path: "/api/v1/visitas"
tags: ["Visitas"]
---

# Crea una visita

`POST /api/v1/visitas`

## 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/visitas`
- Auth: API key in header `Authorization`

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



**Requisitos:**
- `visitas_create`

## Request body

- VisitaCrearRequest
  - `idAgente` integer: Id del agente
  - `referenciaCliente` integer: Referencia del cliente a vincular
  - `referenciaInmueble` string, nullable: Referencia del inmueble a vincular
  - `referenciaSolicitud` integer, nullable: Referencia de la solicitud a vincular
  - `referenciaDemanda` integer, nullable: Referencia de la demanda a vincular
  - `operacion` 'Venta' | 'Alquiler' | 'Traspaso'
  - `idTipo` integer: Id del tipo de visita
  - `lugar` string, nullable: Lugar de la visita
  - `estado` 'Pendiente' | 'Finalizado' | 'Cancelado' | 'Aplazado' | 'Archivado'
  - `fechaInicio` string, date-time: Fecha de inicio de la visita (YYYY-MM-DD HH:MM:SS)
  - `fechaFin` string, date-time, nullable: Fecha de fin de la visita (YYYY-MM-DD HH:MM:SS)
  - `enviarEmailPropietario` boolean: Enviar email al propietario si la visita está finalizada. Por defecto False
  - `sincronizar` boolean, nullable: Sincronizar la visita con Google Calendar. Es necesario haber configurado la sincronización con Google Calendar desde Mobilia. Por defecto False

## Response `200`

OK

- VisitaResponseApiResponse
  - `datos` VisitaResponse
    - `idVisita` integer
    - `idAgente` integer
    - `referenciaCliente` integer
    - `referenciaInmueble` integer
    - `referenciaPersonalizadaInmueble` string, nullable
    - `referenciaSolicitud` integer, nullable
    - `referenciaDemanda` integer, nullable
    - `lugar` string, nullable
    - `idTipo` integer, nullable
    - `idEstadoVisita` integer, nullable
    - `operacion` string, nullable
    - `sincronizar` boolean, nullable
    - `fechaInicio` string, date-time, nullable
    - `fechaFin` string, date-time, nullable

## Changes

- **2026-11-06** `d893803b00d5`: 1 info
  - added the optional property `datos/referenciaPersonalizadaInmueble` to the response with the `200` status

[Operation history](https://skmtc.dev/mobiliagestion/apis/mobilia-public-api/changes/api/v1/visitas/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)