Jira Cloud

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

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 in your Atlassian account that allows Tidal to retrieve compliance data. An API token is an Atlassian mechanism that enables external applications (Tidal) to securely access your Jira resources.

Configuration steps:

Create API token
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 top right
Token configuration:
- Label: Tidal Control Integration
- Click Create
- Copy token value immediately (no longer visible after closing)
- Click Close

Info

Token validity: Jira Cloud API tokens have a maximum validity period of one year. When your API token expires, Tidal Control can no longer retrieve data from your Jira Cloud environment.

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

Tip

API URL format: Always use complete URL including https:// (e.g. https://company.atlassian.net)

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, a link icon will be present in Tidal Tasks and Issues, and Jira-specific tests are available in the Tests section. Test refreshes now deliver results without authentication errors.

Warning

Save API token: Note the API token securely - it's no longer visible after creation and uniquely needed for troubleshooting

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

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.

Info

Gathering support info: Note which browser you're using, exact error messages, which steps you've already tried, and screenshots of the problem. This significantly speeds up the solution.