Acceso API de members). After that, each member creates their own credential. Turning the switch off blocks new use; it does not undo work already saved in the CRM. Reactivating it does not restore revoked keys.
Identity
A personal credential (API key or OAuth) is bound to one membership and one organization. Every read and write is limited to that portfolio.- Asking for extra OAuth scopes does not grant admin. Scopes are clipped to the operational profile when the token is issued (and again at authenticate for older grants).
- Promoting the user to admin does not widen an existing personal credential.
- Leaving and rejoining does not revive the previous membership’s keys or grants. Create new ones.
Operational profile
Personal credentials always carry this set:leads:read, leads:write, pipeline:read, sequences:read, sequences:write, whatsapp:read, whatsapp:write.
Routes outside this profile return 403 FORBIDDEN (This credential cannot perform this operation), even if the same HTTP path exists for other credentials.
What you can do
Details live in the Leads, Sequences, and WhatsApp reference.
A lead (or sequence participation) that is not in the current portfolio returns
404 NOT_FOUND. Reassignment or disable takes effect immediately.
Commercial follow-up
PATCH /leads/{leadId}/commercial updates status, stageId, temperature, estimatedValue, and the next follow-up (followUpAt, followUpChannel, followUpNote, completeFollowUp). It does not change assignment, source, consents, or customFields.
Unknown stageId → 400 INVALID_STAGE. An active follow-up that would be overwritten → 409 FOLLOW_UP_ACTIVE (complete it or clear it first).
Enrichment
POST /leads/{leadId}/enrichment fills empty fields by default (firstName, lastName, email, phone, company, jobTitle, city, state, country).
To overwrite a value that already exists, send correct: [{ field, expected }]. If expected no longer matches the stored value → 409 STALE_CORRECTION. If email or phone already belong to another lead → 409 IDENTITY_CONFLICT (the other record is not revealed).
Sequences
GET /sequences with a personal credential returns running sequences only, as { id, name, channel, status }. It does not include channelConfig, audience criteria, throttle, or org-wide progress.
POST .../sequence-contactsenrolls one portfolio lead. Failures:400 SEQUENCE_INACTIVE,400 INELIGIBLE,409 ALREADY_ENROLLED.pauseis a manual pause; progress is kept.resumeundoes that pause only if the sequence is still running and the lead is still eligible. A futurescheduledAtis kept.withdrawends participation. The member cannot enroll that lead in the same sequence again (409 WITHDRAWNif already ended).
whatsapp:read; send requires whatsapp:write. A rejected send never reaches the provider. Audit logs do not store the message body.
Using another member’s account or the org-global account → 403 FORBIDDEN. Opt-out → 400 OPTED_OUT. Unusable account → 400 ACCOUNT_UNAVAILABLE. Number paused or out of budget → 429 NUMBER_RATE_LIMITED.