Saltar al contenido principal

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.

Cada API key lleva una lista de scopes. Una petición falla con 403 FORBIDDEN si a la key le falta cualquier scope requerido, con un mensaje del estilo:
Insufficient permissions. Missing scopes: leads:write

Scopes disponibles

ScopePermite
leads:readListar, obtener, buscar leads. Leer actividades y etapas del pipeline.
leads:writeCrear, actualizar, eliminar leads. Agregar notas y comunicaciones.
projects:readListar y obtener proyectos y unidades.
projects:writeCrear, actualizar, eliminar proyectos y unidades.
members:readListar miembros de la organización.
pipeline:readLeer etapas del pipeline (también cubierto por leads:read).
lead-sources:readLeer el catálogo de fuentes de leads (también cubierto por leads:read).
webhooks:manageListar tipos de eventos, crear / listar / eliminar suscripciones a webhooks.
Cada sección de endpoint en la Referencia API indica el scope exacto que requiere.

Cómo elegir scopes

Patrones comunes:
  • Solo ingestión de leads (formulario de Meta Ads, formulario web, landing page): leads:write.
  • Sincronización bidireccional (un CRM que necesita leer y actualizar leads): leads:read, leads:write.
  • BI / reportes (dashboards de solo lectura): leads:read, projects:read, members:read.
  • Publicador de catálogo (sincroniza disponibilidad de unidades a un sitio web): projects:read, projects:write.
  • Orquestador de webhooks (conectores Zapier, Make, n8n): webhooks:manage más los scopes read/write que realmente uses.
Puedes editar los scopes de una key en el panel cuando quieras. Los cambios surten efecto en el siguiente request.