# Jira Cloud

> Connect Jira Cloud to Tidal Control with an API token, so compliance tests read your Jira environment and Tidal tasks can become work items in your project.

Source: https://tidalcontrol.com/docs/integrations/jira-cloud

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.

Because Jira Cloud is also an issue tracker, the integration works in **two directions**: Tidal runs compliance tests on your Jira environment (Jira → Tidal), and you can create, link and sync work items in Jira from Tidal tasks and issues (Tidal → Jira). See [External issues](/docs/integrations/external-issues) for that workflow.

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

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:**

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`** 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")

## Sending tasks and issues to Jira (Tidal Control → Jira)

From any Tidal task or issue you can create a Jira work item (or link an existing one), and Tidal keeps its status in sync in the task overview. When adding an external issue, select your Jira connection, the **project**, and the **issue type**; the rest of the flow is the same for every issue tracker.

See **[External issues](/docs/integrations/external-issues)** for the full create / link / sync workflow and the task-overview status column.

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

If the integration does not connect, check the following:

- 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](https://support.atlassian.com/organization-administration/docs/manage-an-organization-with-the-admin-apis/)

### Still can't figure it out?

Send an email to support@tidalcontrol.com, and we'll get back to you 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.