Connect Atlassian to Lutril
Lutril connects to Atlassian (Jira and Confluence Cloud) with a single organization API key. It reads your organization directory, invites people onto a site, and suspends their access when a time boxed grant ends. No Jira API token is involved, so nobody needs the Browse users and groups permission.
Access requested
- read:orgs:admin (identify the organization)
- read:directories:admin (list users and directories)
- read:workspaces:admin (find the Jira or Confluence site to grant access to)
- read:accounts:admin (read account details)
- write:accounts:admin (invite a user, suspend and restore access)
Setup steps
- 1
Open Atlassian Administration and select your organization. You must be an organization admin to create a key.
Open Atlassian Administration - 2
Go to Organization settings, then API keys, then API keys with scopes, and select Create API key.
- 3
Name the key, set an expiry (one year maximum), then select the five scopes listed above. Leave delete:accounts:admin unchecked: Lutril never deletes an Atlassian account, it only suspends access, which is reversible.
Scopes reference - 4
Select Create, then copy the key immediately. Atlassian does not store its value and will not show it again.
- 5
Copy your organization ID from the admin.atlassian.com address bar: it is the part after /o/. A scoped key is tied to one organization and does not name it back, so Lutril cannot discover it.
- 6
In Lutril, connect Atlassian, then paste the API key and the organization ID. Fill the site field (for example mycompany.atlassian.net) only if your organization runs several Jira or Confluence sites.
Where to create it
Official docs
Sign in to Lutril to connect Atlassian, or book a demo and we set it up with you. No slides.