# Zephyr

> Link Zephyr Cloud test cases and plans to Testsigma and export run results back to Zephyr.

Zephyr Cloud integration links Zephyr test cases and test plans with their Testsigma counterparts and exports run results back. Link artifacts by ID once connected.

## Prerequisites

- A valid **Personal Access Token** from Zephyr Cloud.
- Your Jira **Account URL**, **Username**, and **API key**.

## Connect Zephyr Cloud

1. **Open integrations**: from the left navigation bar, go to **Settings > Integrations**.

2. **Enable Zephyr Cloud**: turn on the toggle for **Zephyr Cloud**.

3. **Enter credentials**: in the **Zephyr Cloud Details** dialog box, select the **Region of your Zephyr instance**, then enter your **Personal Access Token** and **Jira Details**.

   ![The Zephyr Cloud details dialog, with the region, token, and Jira fields](https://s3.amazonaws.com/website-static-docs.testsigma.com/new_images/projects/Updated_Doc_Images/Zephyr_Cloud_Details.png)

4. **Save**: click **Save & Enable**.

## Link a test case

1. **Copy the ID**: get the **ID** of an existing test case from **Zephyr Cloud**.

2. **Open the test case**: in Testsigma, go to **Create Tests > Test Cases** and open the test case you want to link, then click **Manage Test Case**.

3. **Link it**: enter the Zephyr test case ID and click the **Link** button.

## Link a test plan

1. **Copy the ID**: get the **ID** of an existing test plan from **Zephyr Cloud**.

2. **Open the test plan**: in Testsigma, go to **Test Plans** and open the test plan you want to link.

3. **Link it**: enter the **Zephyr Project ID** and click the **Link** button.

## Check results in Zephyr

Execute the linked test plan in Testsigma and wait for it to complete. Then click **Zephyr Execution**. You are redirected to **Zephyr Cloud**, where you can view the execution details.
