Skip to main content

​
Overview

With this integration, you can:
  • Automatically create test cycles and executions in your Zephyr-enabled Jira project
  • Sync test results from your automated test suite to Jira via the Zephyr API
This integration currently supports syncing results to a single Zephyr-enabled Jira project.

​
How It Works

1
Your automated test suite is triggered.
2
The integration identifies corresponding Zephyr test cases via test keys or mappings.
3
A new test cycle (or an existing one) is used to house a test execution.
4
Execution results are reported to Zephyr, and linked Jira issues are automatically updated with statuses and artifacts.

​
What Gets Synced

  • Test executions: created in a Jira project with Zephyr enabled
  • Execution results: Passed, Failed, Skipped, etc.
  • Metadata: Test cycle name, environment info

​
Requirements

​
Jira & Zephyr Configuration

  • ✅ Active Jira Cloud account
  • ✅ Zephyr for Jira installed and licensed
  • ✅ API access enabled (available for Zephyr Scale and Zephyr Squad via Atlassian REST API)
  • ✅ A designated Jira project for automated test result syncing
  • ✅ Existing test cases in Zephyr (created manually or imported in advance)

​
Authentication

You will need to provide:
  • Jira user email
  • API token (generated via Atlassian account)
  • Jira base URL
  • Zephyr project key (e.g., QA, TEST)
  • (Optional) Default test cycle name or structure
Note: Zephyr’s API uses basic authentication with an email + API token. For added security, ensure credentials are transmitted via a secure channel.

​
Setup Instructions (Step-by-Step)

​
1. Generate an API Token

1
Log into your Atlassian account.
2
Go to id.atlassian.com/manage-profile/security/api-tokens.
3
Click “Create API token”, name it (e.g., “Zephyr Integration”), and generate it.
4
Copy and securely store the token.

​
2. Identify Your Zephyr Project

  • Use or create a Jira project where your Zephyr test cases reside.
  • Share the project key (e.g., QA, MOBILE, WEBAPP) with your integration provider.

​
3. (Optional) Prepare Test Cycles

If you want to group test executions into a specific test cycle (e.g., “Nightly Automation”), either create the cycle manually or provide a naming convention for the integration to follow.

​
4. Share Credentials Securely

Provide the following details:
  • Jira user email
  • API token
  • Jira base URL
  • Project key
  • (Optional) Default test cycle name

​
5. Run and Verify

Trigger your automated test suite and verify:
  • A test cycle and test execution are created in Zephyr
  • Execution results are visible in the linked Jira test cases
  • Statuses (e.g., passed, failed) are reflected correctly

​
Frequently Asked Questions (FAQ)

No. Test cases must already exist in Zephyr. The integration maps test results to existing test case IDs.
This integration currently supports syncing with a single Zephyr project at a time. Multi-project support may be considered in the future.

​
Known Limitations

  • ✅ Supports Jira Cloud + Zephyr (Squad or Scale)
  • ⚠️ Only one project can be configured per integration
  • ⚠️ Test case creation is not supported — test cases must already exist
  • ⚠️ Limited support for custom fields unless explicitly configured

​
Support

Need help with setup or troubleshooting? Contact our support team or your assigned solutions engineer for guided setup assistance and validation.
Last modified on February 9, 2026