> ## Documentation Index
> Fetch the complete documentation index at: https://docs.axiomancer.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Atlassian (Jira & Confluence)

> Connect an Atlassian Cloud organization to Layer to inventory users, groups, and Jira/Confluence project access for compliance and offboarding workflows.

<Warning>
  The one-click 3LO OAuth flow for Atlassian is in active development ([LAY-247](https://linear.app/mcclawd/issue/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](https://id.atlassian.com/manage-profile/security/api-tokens) and paste it into Layer's Connect modal along with your Atlassian Organization ID.
</Warning>

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

<Steps>
  <Step title="Open the Atlassian integration in Layer">
    In Layer, go to **Integrations**, find Atlassian, and click **Connect**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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**.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## What gets synced

| Object            | Fields                                  | Refresh cadence |
| ----------------- | --------------------------------------- | --------------- |
| Users             | account ID, email, display name, status | Every 6 hours   |
| Groups            | name, members                           | Every 6 hours   |
| Jira projects     | name, key, lead                         | Daily           |
| Confluence spaces | key, name, type                         | Daily           |

## 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

<AccordionGroup>
  <Accordion title="Atlassian says my account isn't an org admin">
    Org admin is configured at [admin.atlassian.com](https://admin.atlassian.com), not inside Jira or Confluence settings. Have an existing org admin promote you, then retry.
  </Accordion>

  <Accordion title="I see Jira data but no Confluence">
    Confluence has to be a product on the same Atlassian organization. Check at [admin.atlassian.com → Products](https://admin.atlassian.com).
  </Accordion>
</AccordionGroup>