Skip to main content
Issue trackers are in preview and are enabled per organization. Ask your Datafold contact or support@datafold.com to turn them on.
Datafold files and updates Jira work items as an Atlassian service account, not as you. One Jira site connects to one Datafold organization. Datafold supports Jira Cloud. Jira Data Center is not supported.

​
1. Create a service account and a credential

Your Atlassian organization must use centralized user management to create service accounts.
1

Create a service account

In admin.atlassian.com, open Directory → Service accounts and create a service account.
2

Give it access to Jira

Give the service account access to Jira on your site, with a role that can create and edit work items in the projects that Datafold will use.
3

Create an OAuth 2.0 credential

Open the service account, choose Create credentials → OAuth 2.0, and select these scopes:
  • read:jira-work
  • write:jira-work
  • read:jira-user
Copy the client ID and the client secret. Atlassian shows the secret only once.

​
2. Connect Jira in Datafold

Go to Settings → Integrations → Issue Trackers, click Add new integration, and choose Jira. Fill in the form and click Connect:
  • Site URL: your Jira Cloud address, which must have the form https://<name>.atlassian.net.
  • Client ID: the client ID of the service account’s credential.
  • Client secret: the client secret of the same credential.
Datafold checks the credential and its scopes before it saves them. The status then shows the site and the service account.

​
Rotate the secret

If Jira refuses the credential (for example, after the secret is rotated or deleted), the page shows Jira refused the credential. Create a new OAuth 2.0 secret for the service account in admin.atlassian.com, enter it in the form with the same client ID, and click Update credential.

​
Disconnect

Disconnect makes Datafold forget the credential. Atlassian cannot revoke the credential for Datafold, so delete the service account’s OAuth 2.0 credential yourself in admin.atlassian.com. It stays valid until you do.