---

title: Jira Cloud description: Configure Jira Cloud integration for automatic compliance monitoring in Tidal Control sidebar_position: 7

Jira Cloud

Configuring Jira Cloud integration

The Jira Cloud integration enables Tidal Control to automatically execute compliance tests on your Jira environment via an API token configuration.

Jira Cloud is a powerful tool for issue tracking and project management that helps teams plan, assign, track, report and manage work within various projects.

Requirements:

• Super User role in Tidal Control
• Jira Cloud account with project access
• Atlassian account management rights
• Access to Jira Cloud instance

Configuration step-by-step plan

What we're going to do: We'll create a Jira API token with scopes in your Atlassian account that allows Tidal to retrieve compliance data. A scoped API token is an Atlassian mechanism that enables external applications (Tidal) to securely access specific Jira resources with limited rights.

Configuration steps:

1. Create API token
2. Complete integration

Step 1: Create API token

• Go to Atlassian Account API Tokens at https://id.atlassian.com/manage-profile/security/api-tokens

• Log in with your Jira Cloud account

• Click Create API token with scopes top right

• Token configuration:

  • Label: Tidal Control Integration
  • Expiry date: Select desired validity period (max. 1 year)
  • Click Next
  • Select Jira as the app for the API token
  • Click Next
  • Select the following scopes:
    • read:jira-user
    • read:jira-work
  • Click Next

• Complete token:

  • Check API token details
  • Click Create token
  • Copy token value immediately (no longer visible after closing)
  • Click Close

Step 2: Complete integration

• Go to Settings → Integrations in Tidal Control
• Click the plus icon next to Jira Cloud
• Fill in configuration:
  • Name: Jira Production
  • Username: The email address you use to log into Jira (and that was used to create the API token)
  • API url: Your Jira instance URL (format: https://yourcompany.atlassian.net)
  • API token: Copied token value (from step 1)
• Click "Create" to save integration

Setup for multiple sites

If you need to connect multiple Jira sites to Tidal Control:

• Repeat token creation for each Jira site
• Configure separate integration in Tidal per site
• Use descriptive names to distinguish sites (e.g. "Jira Development", "Jira Operations")

Verification

After successful configuration, Settings → Integrations shows a "Connected" status for Jira Cloud, Jira-specific tests are available in the Tests section, and test refreshes deliver results without authentication errors.

Troubleshooting

Troubleshooting issues:

• Verify API token is correctly copied (no extra spaces)
• Check API URL format including https:// and correct domain
• Confirm username matches the email address of the person who created the token
• Check that token expiry date has not been reached
• Confirm that the API token has the correct permissions (read:jira-user, read:jira-work)

For more information about Jira Cloud API management: See official Atlassian documentation

Still having trouble?

Send an email to support@tidalcontrol.com, and we'll get in touch as soon as possible.