---
metadata:
- name: generator
content: Diplodoc Platform v5.39.1
alternate:
- https://yandex.com.tr/support/forms/en/create-task.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com.tr/support/forms/en/llms.txt
# Creating an issue in Yandex Tracker
{% note warning "" %}
Only Yandex Forms for Business users can set up integration with Yandex Tracker.
{% endnote %}
You can integrate your form with [Yandex Tracker](https://tracker.yandex.com) to automatically create issues from user responses. The user's answers are sent from the form to Yandex Tracker, and a new issue is created based on the submitted information. This flow can be useful for accepting service requests, collecting error logs, and similar scenarios. For more information about issues, see [Yandex Tracker Help](https://yandex.com/support/tracker/user/create-ticket.html).
## Set up issue creation in Yandex Tracker {#setup}
1. Select the desired form and open the **Integration** tab.
1. Select an [action group](https://yandex.com.tr/support/forms/en/notifications.md#add-integration) for which you want to set up issue creation and click  **Tracker** at the bottom of the group.
1. Enter the [queue](https://yandex.com/support/tracker/queue-intro.html) key to create your issue in.
1. To create a [sub-issue](https://yandex.com/support/tracker/user/create-ticket.html#subtask), enable **Convert to sub-issue** and enter the parent issue key.
1. Set up the type, issue priority, and other parameters:
- In the **Author**, **Assignee**, and **Followers** fields, specify a username in `user` format.
To specify multiple users in the **Followers** field, enter their usernames separated by commas (for example, `smith,johnson`).
- If the integration settings don't specify the **Author** and a user from your organization completes the form, that user will be specified as the issue's author.
If an unauthorized user completes the form, Tracker Robot (`yndx-tracker-cnt-robot@`) is specified in the **Author** field.
- The remaining fields should be completed exactly as they appear in Yandex Tracker.
- To add multiple values to the **Components** or **Tags** field, separate them with commas.
- You can use YFM markup in the issue description. To learn more, see [Yandex Tracker Help](https://yandex.com/support/tracker/user/syntax-yfm.html).
{% note info "" %}
No suggestions appear when entering values in the fields such as **Author**, **Assignee**, **Tags**, or **Components**.
{% endnote %}
1. You can also create a new field if the one you need isn't available in the issue parameters. To do this, click **Add issue parameter** and start typing its name, then select the desired parameter from the suggested options.
For more information about issue parameters, [Yandex Tracker Help](https://yandex.com/support/tracker/user/create-param.html).
1. To populate the issue fields with answers to questions or other data from the form:
1. Select a field and click on the right.
1. Select a [variable](https://yandex.com.tr/support/forms/en/vars.md) from the list to add to the field.
For example, if your form collects error messages, you can add the user's message and technical details to the issue description.
Fields can also contain an **Answer to question** variable. If an answer contains [YFM markup](https://yandex.com/support/tracker/user/syntax-yfm.html) elements, they are automatically converted to text formatting elements when you add the answer to the issue description in Yandex Tracker.
{.border-grey}
{% note warning "" %}
To add an employee specified in an answer to a People, to the **Author**, **Assignee**, **Followers** fields in Tracker, add a **Question answer option ID** variable to the field. If you use an **Answer to question** variable, integration won't work.
{% endnote %}
1. To get a link to the new issue after filling out the form, enable the **Show messages about the results of actions** option under the action name.
1. Click **Save**.
To create multiple issues at once, add new actions by clicking  **Tracker** at the bottom of the page.
## Example {#example}
If you want an issue to only be created for users who give certain answers, [set your conditions](https://yandex.com.tr/support/forms/en/notifications.md#conditions).
> Example of integration with Yandex Tracker for a request form for equipment procurement. Employees can use this form to submit equipment requests, and these requests will be transformed into issues for the procurement department.
>
> {.border-grey}
## Embed a form in the Yandex Tracker interface {#embed}
{% include [embed-form](./_includes/embed-form-2ce82a078420.md) %}
## Troubleshooting {#troubles}
{% include notitle [inregration-errors](_includes/inregration-errors-633101021e33.md) %}
### Error in the Author, Assignee, and Follower fields {#error-author}
The error may be caused by invalid data being sent from the form to the **Author**, **Assignee**, or **Followers** issue field. Fill in these fields in the following way:
- To add an employee manually, enter a username like `smith`.
- To add an employee specified in an answer to a People,, insert a **Question answer option ID** [variable](https://yandex.com.tr/support/forms/en/vars.md) in the field. If you use an **Answer to question** variable, integration won't work.
- To add an employee specified in an answer to a Drop-down list or Multiple answers question, set usernames (e.g., `smith`) as answer options and use the **Answer to question** [variable](https://yandex.com.tr/support/forms/en/vars.md).
If there is an error in the **Author** field even though the field is populated correctly, make sure the user filling out the form is [authorized to create issues in the specified Yandex Tracker queue](#access).
### Error: No rights to add issues to queue {#access}
This error occurs because the user who filled out the form doesn't have the rights to create issues in the specified Yandex Tracker queue. Ask the queue owner to [check access rights](https://yandex.com/support/tracker/manager/queue-access.html).
### The issue description displays incorrectly {#error-text}
Check your YFM markup for errors if you used it to format the text in the **Description** field. To see how your marked-up text will appear, paste it into an issue description in Yandex Tracker or onto a Wiki page.
For example, the text may display incorrectly if there is no empty line before a block element (such as `{% note %}`) or if extra spaces are added after closing an HTML block (`::: `). For more information about markup, see [Yandex Tracker Help](https://yandex.com/support/tracker/user/syntax-yfm.html).
{% include [style](https://yandex.com.tr/support/forms/en/_assets/style-a13ddc9841bc.md) %}