Work management
Jira
Connect Jira Cloud or Data Center so Jira issues, sprints, and statuses flow into Atlas project intelligence.
What this connector does
- Sync projects, boards, sprints, and issues into Atlas.
- Reflect status, assignee, and label changes both directions after mapping approval.
- Convert Jira issues into Atlas tasks without exposing private description bodies.
- Listen for issue events so timelines stay live.
Before you begin
- You are a Jira site administrator.
- You have the workspace cloudid or, for Data Center, the base URL.
- You have a sandbox project for first validation.
Get your credentials
Open the Atlassian developer console
Sign in with the site admin account. developer.atlassian.com console
Create an OAuth 2.0 (3LO) app
Click Create, OAuth 2.0 integration, and name it Atlas Connector.
Add the Atlas callback URL
In Authorization, set Callback URL to https://YOUR-ATLAS-HOST/oauth/callback/jira.
Add Jira scopes
In Permissions, add Jira API and request the scopes listed below.
Copy the client id and secret
In Settings, copy the Client ID and Secret into the Atlas Jira connector settings page.
Required scopes and permissions
read:jira-workwrite:jira-workread:meoffline_accessSetup checklist
- Create the provider app in a sandbox or development workspace.
- Add the Atlas redirect URL to the provider app configuration.
- Copy the client id, client secret, or API key.
- Paste the credentials into the Atlas connector settings page.
- Click Connect and complete the provider sign-in screen.
- Run Test connection from the connector page to verify health.
Troubleshooting
invalid_grant
The OAuth code expired. Retry the connect flow.
No accessible resources
The user who completed OAuth has no Jira site access. Sign in as a site admin.
Data Center webhooks not arriving
Confirm the Atlas hostname is on the allowlist in Jira Administration, System, Outgoing Mail / Webhooks.
Webhooks
Atlas creates per-project webhooks on Jira Cloud and validates the Atlassian-Webhook-Identifier header on every event.
Events Atlas listens for
- Issue created
- Issue updated
- Comment created
- Sprint started or closed
Provider docs: https://developer.atlassian.com/cloud/jira/platform/webhooks/
Disconnect and data deletion
- Click Disconnect on the Atlas Jira connector page.
- Open Atlassian Account, Connected apps and revoke Atlas Connector.
- Atlas removes per-project webhook subscriptions on disconnect.
Once you have the credentials above, paste them into the live connector page to finish connecting Jira.
Open the Jira connector page