Skip to main content
The one-click 3LO OAuth flow for Atlassian is in active development (LAY-247). For now, connecting Atlassian uses an Org Admin API token. The instructions below describe the OAuth flow that’s coming; until then create an API token at id.atlassian.com/manage-profile/security/api-tokens and paste it into Layer’s Connect modal along with your Atlassian Organization ID.
The Atlassian integration covers both Jira and Confluence Cloud. One sign-in connects both products.

​
What you’ll need

  • Atlassian Cloud Organization Admin role.
  • Three minutes.

​
Set it up

1

Open the Atlassian integration in Layer

In Layer, go to Integrations, find Atlassian, and click Connect.
2

Sign in with your org-admin account

You’ll be redirected to Atlassian’s OAuth screen. Sign in with the org-admin account for the Atlassian organization you want to connect.
3

Authorize the requested scopes

Atlassian will list the requested scopes:
  • read:jira-user, read:jira-work — list users and issues
  • read:confluence-content.summary, read:confluence-space.summary, read:confluence-user — list pages and spaces
  • read:me — identify the connecting admin
Click Accept.
4

Wait for the first sync

The initial sync resolves your organization’s cloud_id and pulls users, projects, and spaces. Typically finishes in 5-15 minutes.

​
What gets synced

ObjectFieldsRefresh cadence
Usersaccount ID, email, display name, statusEvery 6 hours
Groupsname, membersEvery 6 hours
Jira projectsname, key, leadDaily
Confluence spaceskey, name, typeDaily

​
Token refresh

Atlassian access tokens expire after one hour. Layer automatically refreshes tokens in the background each time a sync runs, so your connection stays active without any manual re-authorization. If a refresh fails — for example, because the admin revoked access in the Atlassian admin console — the connection status changes to needs re-auth and you can reconnect with one click.

​
Troubleshooting

Org admin is configured at admin.atlassian.com, not inside Jira or Confluence settings. Have an existing org admin promote you, then retry.
Confluence has to be a product on the same Atlassian organization. Check at admin.atlassian.com → Products.