# Jira

Connect your Jira Cloud project to Zigpoll and automatically create issues from survey responses. Each response generates a new issue in your chosen Jira project, complete with the survey title, participant info, and all submitted answers.

**Step #1: Connect your Jira Account**

1. In Zigpoll: Click Settings -> Manage Integrations -> Enable the Jira Integration.
2. Click "Click to Connect" to authorize Zigpoll with your Atlassian account.
3. You will be redirected to Atlassian to grant access. Once approved, you'll return to Zigpoll automatically.

**Step #2: Configure Issue Creation**

1. **Select a Survey** — Choose which survey should trigger issue creation, or select "All Surveys" to create issues for every survey response.
2. **Select a Project** — Pick the Jira project where issues should be created.
3. **Select an Issue Type** — Pick the issue type (e.g., Task, Bug, Story) for the created issues.

**Step #3: Configure Issue Creation Rules**

Choose when issues should be created:

* **Create an issue if the survey is partially completed** — An issue is created for every response, even if the survey is not fully completed.
* **Create an issue only if the survey is fully completed** — Issues are only created once the participant finishes the entire survey.
* **Create an issue only if the respondent submitted an email address** — Issues are only created when the participant provides an email.
* **Create an issue only if an open-ended response is submitted** — Issues are only created when the participant writes a free-text answer.

**Step #4: Save Changes**

Click "Save Changes" to activate the integration.

**That's it.** Zigpoll will now create a new issue in your selected Jira project each time a matching survey response is submitted. The issue will include the survey name, participant details, and all responses.

### Multiple Projects

You can add multiple configurations to route different surveys to different Jira projects. Click "Click here to add another project" to add additional entries. Each configuration has its own survey filter, project destination, issue type, and creation rules.

### Token Refresh

Jira access tokens expire after one hour. Zigpoll automatically refreshes your token when needed, so you don't need to re-authorize.


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.zigpoll.com/integrations/jira.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.