Connect Neon to Lutril
Lutril connects to Neon with a personal API key and reads your organization members with their role, whether they have multi factor enabled and whether their Neon account has been deactivated. Access is time boxed from both ends: a grant invites somebody or raises the organization role on a membership they already have, and the deadline writes the previous role back or removes the membership.
Access requested
- The key is not scope based. What matters is its KIND: Neon does not accept organization API keys for invitations or member removal at all, so it has to be a PERSONAL key.
- That personal key's account must itself be an admin of the organization, or Neon refuses every write while still returning the roster.
Setup steps
- 1
Sign in to Neon with an account that is an ADMIN of the organization, then open Account settings and go to API keys.
Create a Neon API key - 2
Create a PERSONAL API key, not an organization one. This is the single most common mistake with Neon: an organization key lists members perfectly and then fails every invitation and every removal, which reads like a broken integration rather than a wrong key type. Neon's own documentation states that organization API keys are not supported for those calls.
Neon organizations API - 3
Copy the key when it appears. Neon shows it once.
- 4
Find your organization ID. It is the org- value in Organization settings.
- 5
In Lutril, connect Neon and paste the key and the organization ID.
- 6
To time box Neon access, set the access levels on the Neon app in your catalogue to viewer, collaborator, editor and admin. Those are Neon's own role names. Neon also still accepts member as an older name for editor, and Lutril treats the two as the same role so a grant does not re-apply access somebody already has.
Managing Neon organizations - 7
A grant only ever raises a role. Anyone who already holds the role they asked for, or a higher one, is left exactly as they were, so a deadline can never take away access that Lutril did not grant.
- 8
Neon will not leave an organization without an admin, so a change that would remove the last one is refused with an explanation rather than attempted.
- 9
A person whose Neon ACCOUNT is deactivated is refused rather than reported as reinstated. Deactivation belongs to their own Neon account rather than to the membership, and Neon's API cannot undo it, so they have to restore it themselves.
- 10
Removing somebody takes them out of the organization and leaves their Neon account alone, so the next grant invites them back.
Where to create it
Official docs
Sign in to Lutril to connect Neon, or book a demo and we set it up with you. No slides.