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 headerAuthorization. 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.
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:managemás los scopes read/write que realmente uses.