Scopes

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

Scope	Permite
`leads:read`	Listar, obtener, buscar leads. Leer actividades y etapas del pipeline.
`leads:write`	Crear, actualizar, eliminar leads. Agregar notas y comunicaciones.
`projects:read`	Listar y obtener proyectos y unidades.
`projects:write`	Crear, actualizar, eliminar proyectos y unidades.
`members:read`	Listar miembros de la organización.
`pipeline:read`	Leer etapas del pipeline (también cubierto por `leads:read`).
`lead-sources:read`	Leer el catálogo de fuentes de leads (también cubierto por `leads:read`).
`webhooks:manage`	Listar 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.

Empezar

Conceptos centrales

Webhooks

Referencia

Scopes disponibles

Cómo elegir scopes

​Scopes disponibles

​Cómo elegir scopes

Scopes disponibles

Cómo elegir scopes