---
title: "Hold Previsualizacion Slot"
method: POST
path: "/api/_previsualizacion/hold"
tags: ["scheduling", "appointments_previsualizacion"]
---

# Hold Previsualizacion Slot

`POST /api/_previsualizacion/hold`

## Request

- Base URL: `https://api.hogarsolar.es` (the document declares no server; this is the origin it was published from)
- URL: `https://api.hogarsolar.es/api/_previsualizacion/hold`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/hogarsolar/apis/hogarsolar-backend-api/docs/api/_previsualizacion/hold/post.ts> (a function with typed inputs; its response is checked against the schema)

Reserva provisional (presupuestador): ocupa el hueco en Calendar sin tocar HubSpot.

## Query parameters

- `contact_id` string, required

## Request body

- PreviewAppointmentSelection: Schema específico para reservas de previsualización
  - `appointment_type` 'previsualizacion', required: Tipo de cita (solo previsualización)
  - `day` string, nullable: Fecha de la cita en formato YYYY-MM-DD
  - `time` string, nullable: Hora de la cita en formato HH:MM
  - `address` string, nullable: Dirección donde se realizará la cita (se obtiene de HubSpot si no se proporciona)
  - `zip` string, nullable: Código postal (5 dígitos)
  - `city` string, nullable: Ciudad
  - `province` string, nullable: Provincia
  - `comercial_email` string, email, nullable: Email del comercial asignado (opcional, se determina automáticamente si no se proporciona)
  - `google_maps_url` string, nullable: URL de Google Maps (opcional)
  - `is_reschedule` boolean: Indica si es un cambio de fecha (permite bypass de validación de cita existente)

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-16** `1dc9ad769f97`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hogarsolar/apis/hogarsolar-backend-api/changes/api/_previsualizacion/hold/post.md)

---

[API](https://skmtc.dev/hogarsolar/apis/hogarsolar-backend-api.md) - [All operations](https://skmtc.dev/hogarsolar/apis/hogarsolar-backend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hogarsolar/apis/hogarsolar-backend-api/revisions/1dc9ad769f97?raw)