Acceso API de members). Después cada member crea su propia credencial. Apagar el interruptor bloquea el uso nuevo; no deshace lo ya guardado en el CRM. Reactivarlo no recupera las claves revocadas.
Identidad
Una credencial personal (API key u OAuth) está atada a una membresía y una organización. Toda lectura y escritura queda en esa cartera.- Pedir scopes OAuth extra no concede administración. Se recortan al perfil operativo al emitir el token (y otra vez al autenticar si el grant era anterior).
- Ascender a admin no amplía una credencial personal ya creada.
- Irse y volver no reactiva las claves ni autorizaciones de la membresía anterior. Hay que crear otras.
Perfil operativo
Las credenciales personales llevan siempre este set:leads:read, leads:write, pipeline:read, sequences:read, sequences:write, whatsapp:read, whatsapp:write.
Las rutas fuera de este perfil responden 403 FORBIDDEN (This credential cannot perform this operation), aunque el mismo path exista para otras credenciales.
Qué puedes hacer
El detalle está en la referencia de Leads, Secuencias y WhatsApp.
Un lead (o una participación en secuencia) que no está en la cartera actual responde
404 NOT_FOUND. Una reasignación o un disable vale de inmediato.
Seguimiento comercial
PATCH /leads/{leadId}/commercial actualiza status, stageId, temperature, estimatedValue y el próximo seguimiento (followUpAt, followUpChannel, followUpNote, completeFollowUp). No cambia asignación, fuente, consentimientos ni customFields.
stageId desconocido → 400 INVALID_STAGE. Un seguimiento activo que se pisaría → 409 FOLLOW_UP_ACTIVE (complétalo o límpialo antes).
Enriquecimiento
POST /leads/{leadId}/enrichment por defecto solo completa campos vacíos (firstName, lastName, email, phone, company, jobTitle, city, state, country).
Para sobrescribir un valor que ya existe, envía correct: [{ field, expected }]. Si expected ya no coincide → 409 STALE_CORRECTION. Si el email o el teléfono ya pertenecen a otro lead → 409 IDENTITY_CONFLICT (no se revela esa otra ficha).
Secuencias
GET /sequences con una credencial personal solo devuelve secuencias activas (running), como { id, name, channel, status }. No incluye channelConfig, criterios de audiencia, throttle ni el progreso agregado de la organización.
POST .../sequence-contactsinscribe un lead de la cartera. Fallos:400 SEQUENCE_INACTIVE,400 INELIGIBLE,409 ALREADY_ENROLLED.pausees una pausa manual; el progreso se conserva.resumesolo deshace esa pausa si la secuencia sigue activa y el lead sigue siendo elegible. ConservascheduledAtsi aún es futuro.withdrawtermina la participación. El member no puede volver a inscribir ese lead en la misma secuencia (409 WITHDRAWNsi ya terminó).
whatsapp:read; enviar, whatsapp:write. Un envío rechazado no llega al proveedor. La auditoría no guarda el cuerpo del mensaje.
Usar la cuenta de otro member o la cuenta global → 403 FORBIDDEN. Baja del canal → 400 OPTED_OUT. Cuenta no utilizable → 400 ACCOUNT_UNAVAILABLE. Número pausado o sin presupuesto → 429 NUMBER_RATE_LIMITED.