> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qawolf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to integrate with Zephyr

> Sync QA Wolf automated test results to Zephyr Test Management for Jira, including test cycles and metadata.

## What QA Wolf syncs to Zephyr

Integrate QA Wolf with [Zephyr Test Management for Jira](https://marketplace.atlassian.com/apps/1213259/zephyr-test-management-and-automation-for-jira) to sync automated test results directly to Jira.

For each QA Wolf run, the integration can:

* Create test executions in Zephyr.
* Associate executions with a test cycle.
* Sync automated test results (passed, failed, skipped).
* Include execution metadata (cycle name, environment).

Results are synced after runs reach Completed status in QA Wolf.

## Limitations

* Cloud-hosted only (Jira Cloud + Zephyr Squad or Scale).
* Only one Zephyr-enabled Jira project can be configured per QA Wolf workspace.
* Zephyr test cases must already exist.
* Custom fields are not supported unless specially configured.

## Configure in Jira / Zephyr

Customers configure Jira and Zephyr. QA Wolf uses the provided credentials to sync results and enable the integration.

<Tip>
  Generating Jira API tokens requires administrator access to the Atlassian account. If you're not an admin, ask one to create the token.
</Tip>

### Jira/Zephyr setup

* Jira Cloud instance.
* Zephyr installed and licensed (Squad or Scale).
* Zephyr-enabled Jira project to receive test executions.
* API access enabled (via Atlassian REST API).
* Zephyr test cases already created (tests are not created automatically).

### Credentials to share with QA Wolf

Once Jira and Zephyr are configured, provide QA Wolf with:

* Jira user email.
* Jira API token.
* Jira base URL.
* Zephyr project key (for example, QA, MOBILE).
* *(Optional)* Default test cycle name or naming convention.

## Verify the integration

After QA Wolf enables the integration:

<Steps>
  <Step>
    Run your automated tests in QA Wolf.
  </Step>

  <Step>
    After the run completes, test executions appear in the configured Zephyr project.
  </Step>

  <Step>
    Executions are grouped under the appropriate test cycle and reflect synced results.

    <Tip>
      If executions do not appear as expected, or if test cases are not mapping correctly, contact QA Wolf for verification.
    </Tip>
  </Step>
</Steps>