Saltar al contenido principal
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:

Scopes disponibles

Cada sección de endpoint en la Referencia API indica el scope exacto que requiere.
Dos endpoints intencionalmente saltan el chequeo de scopes — viven fuera de la superficie autenticada y con rate limit para que monitoreo y los flujos de “probar conexión” de conectores los puedan usar sin necesitar keys con scopes específicos:
  • GET /health — sin header Authorization. Sonda pública de liveness + readiness de BD.
  • GET /me — requiere bearer, pero cualquier bearer válido sirve (incluso uno con set de scopes vacío). Devuelve la organización y los scopes del bearer.
Todo lo demás requiere al menos un scope.

Credenciales personales

Una credencial personal usa siempre el perfil operativo: leads:read, leads:write, pipeline:read, sequences:read, sequences:write, whatsapp:read, whatsapp:write. Esos scopes siguen aplicando solo dentro de la cartera del member y en las rutas que aceptan operaciones de member. Los scopes OAuth extra se recortan. Listar members, proyectos, round robin, calendario, webhooks, o crear leads/secuencias a nivel de organización responde 403 FORBIDDEN.

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.
  • Enrutamiento de leads (auto-asignar leads entrantes en un equipo): round-robin:read, round-robin:write, leads:read.
  • Integración de agenda (leer disponibilidad y agendar eventos en el calendario de un miembro): calendar:read, calendar:write, members:read.
  • Automatización outbound (construir, lanzar y gestionar secuencias de cold-outreach): sequences:read, sequences:write, leads:read.
  • Mensajería de WhatsApp (listar cuentas remitentes y enviar mensajes de WhatsApp puntuales): whatsapp:read, whatsapp:write, leads:read.
  • Automatización de cartera de member (Zapier/Make solo sobre leads asignados): credencial personal; ver Acceso API personal.
  • 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.