> For the complete documentation index, see [llms.txt](https://docs.avoautomation.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.avoautomation.com/avo-assure/integrations-in-avo-assure/test-management/jira-integration/auto-defect-creation.md).

# Auto Defect Creation

Auto Defect Creation in Avo Assure automatically logs defects into JIRA whenever a Test Step fails during execution. It captures failure details like step info, logs, and screenshots, and links the JIRA defect ID back to the Test Step.

## Prerequisites

User must ensure the following requirements are fulfilled before proceeding with Jira integration in Avo Assure.

### Cloud Authentication Prerequisites

For the cloud authentication, here are the prerequisites:

* **Jira Credentials:** Keep Jira login credentials ready to use during authentication.
* **Jira API token:** Generate the Jira API token and store it securely for use during authentication.
* **Jira Instance URL:** Ensure the Jira URL is correct and accessible to use during authentication.
* **Avo Integrator:** Ensure the Avo Integrator extension is downloaded in the browser. This required for Login, Mapping, and Execution Configuration in Avo Assure.

{% hint style="info" %}
**Note:** To integrate with Jira without using the Avo Assure Client, user can install the Avo Integrator Extension in user's browser and perform the integration. For installation steps, refer to [Avo Integrator](/avo-assure/integrations-in-avo-assure/avo-integrator-extension.md).
{% endhint %}

* **Avo Assure Client:** Ensure Avo Assure client is connected and it's required for executing the test case and update status in Jira**.**
* **Mapping Zephyr Scale Test case:** Ensure to map Zephyr Scale Test Case to auto create defect for failed Test step while execution.

{% hint style="info" %}
**Note:** Refer to the document below to learn more about Zephyr Scale Integration.

* For **Zephyr Scale**, refer to [Zephyr Scale](/avo-assure/integrations-in-avo-assure/test-management/zephyr-scale.md).
  {% endhint %}

### Data Center Authentication Prerequisites

For the data center authentication, here are the prerequisites:

* **Username:** Ensure the Jira Username is ready to use during authentication.
* **PAT token:** Generate the PAT (Personal Access token) token and store it securely for use during integration.
* **URL for Jira instance:** Ensure the Jira URL is correct and accessible to use during authentication.
* **Avo Integrator:** Ensure the Avo Integrator extension is downloaded in the browser. This required for Login, Mapping, and Execution Configuration in Avo Assure.

{% hint style="info" %}
**Note:** To integrate with Jira without using the Avo Assure Client, user can install the Avo Integrator Extension in user's browser and perform the integration. For installation steps, refer to [Avo Integrator](/avo-assure/integrations-in-avo-assure/avo-integrator-extension.md)
{% endhint %}

* **Mapping Zephyr Scale**: Ensure to map Zephyr Scale Test Case to auto create defect for failed Test step while execution.

{% hint style="info" %}
**Note:** Refer to the document below to learn more about Zephyr Scale Integration.

* For **Zephyr Scale**, refer to [Zephyr Scale](/avo-assure/integrations-in-avo-assure/test-management/zephyr-scale.md).
  {% endhint %}

### This document includes:

1. [Template Creation](/avo-assure/integrations-in-avo-assure/test-management/jira-integration/auto-defect-creation/template-creation.md)
2. [Configuration and Execution Test Cases](/avo-assure/integrations-in-avo-assure/test-management/jira-integration/auto-defect-creation/configuring-and-executing-test-case.md)
3. [View Defect ID in Avo Assure Reports](/avo-assure/integrations-in-avo-assure/test-management/jira-integration/auto-defect-creation/view-defect-id-in-avo-assure-reports.md)
4. [View Auto Created Defect in Jira](/avo-assure/integrations-in-avo-assure/test-management/jira-integration/auto-defect-creation/view-auto-created-defect-in-jira.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.avoautomation.com/avo-assure/integrations-in-avo-assure/test-management/jira-integration/auto-defect-creation.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.