> ## Documentation Index
> Fetch the complete documentation index at: https://developers.flowestate.app/llms.txt
> Use this file to discover all available pages before exploring further.

# API de FlowEstate

> Construye integraciones sobre FlowEstate. Empuja leads, sincroniza proyectos, gestiona suscripciones a webhooks y reacciona a eventos en tiempo real.

La API de FlowEstate es una API REST en JSON para equipos inmobiliarios que quieren conectar FlowEstate con el resto de su stack — Meta Ads, landing pages, WhatsApp, contabilidad, BI, lo que sea.

* **URL base** — `https://panel.flowestate.app/api/v1`
* **Auth** — `Authorization: Bearer fe_k_<tu_key>`
* **Formato** — JSON entrada y salida, UTF-8

<CardGroup cols={2}>
  <Card title="Inicio rápido" icon="bolt" href="/es/quickstart">
    Obtén una key, dispara tu primer request, ve aparecer un lead en el panel.
  </Card>

  <Card title="Referencia API" icon="code" href="/es/api-reference/overview">
    Cada endpoint con sus scopes, body de request y forma de response.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/es/webhooks">
    Suscríbete a eventos, verifica firmas, evita bucles.
  </Card>

  <Card title="Solución de problemas" icon="life-ring" href="/es/troubleshooting">
    Errores comunes, qué significan y cómo arreglarlos.
  </Card>
</CardGroup>

## Lo que puedes hacer

* **Ingerir leads** desde donde sea — anuncios de Meta, formularios web, landing pages, embudos personalizados — y dejar que FlowEstate maneje scoring, asignación y movimiento de pipeline.
* **Sincronizar tu catálogo** — empuja y actualiza proyectos y unidades (status: available / reserved / sold) para que el resto de tu stack siempre refleje lo que está a la venta.
* **Reaccionar a eventos** — recibe webhooks firmados con HMAC en el momento que se crea un lead, cambia una etapa o se vende una unidad.
* **Buscar y deduplicar** — busca leads existentes por email, teléfono o nombre desde tus propias apps antes de crear duplicados.
* **Gestionar suscripciones programáticamente** — para plataformas partner (Make, Zapier, n8n, integraciones personalizadas) que necesitan registrar destinos de webhook por cuenta de usuarios finales.

## Contrato estable

La versión actual es `v1`. Los cambios aditivos (nuevos campos opcionales, nuevos endpoints) salen in situ. Los cambios incompatibles salen bajo un nuevo prefijo (`v2`). Cuando eso pase, `v1` sigue corriendo durante una ventana de deprecación publicada.

## Soporte

* Email: [soporte@flowestate.app](mailto:soporte@flowestate.app)
* Estado: [status.flowestate.app](https://status.flowestate.app)
* Versión en inglés del sitio: selector de idioma en la barra superior.
