Overview
This node integrates with the YouTrack API to create new issues within a specified project. It is useful for automating issue tracking workflows, such as creating bug reports, feature requests, or task assignments directly from other systems or triggers in your automation workflow.
Practical examples include:
- Automatically creating an issue when a form is submitted.
- Logging errors or incidents detected by monitoring tools as YouTrack issues.
- Creating tasks assigned to specific team members based on external events.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method of authenticating with YouTrack API: either using an Access Token or OAuth2 authentication flow. |
| Receive Fields | Specifies which fields to receive or include in responses for issue operations (create, get, update). |
| Project | The target project where the issue will be created. Can be specified by ID or selected from a searchable list. This is required. |
| Title | The summary or title of the issue. This is a required string field describing the issue briefly. |
| Description | Detailed description of the issue. Required multiline text field. |
| Assignee | Username or identifier of the user to whom the issue will be assigned. Optional string field. |
Output
The node outputs JSON data representing the newly created issue object returned by the YouTrack API. This includes all standard issue fields such as:
idandidReadable: Unique identifiers of the issue.summary: The issue title.description: The detailed description.project: Information about the project the issue belongs to.reporter,assignee: User details related to the issue.customFields,links,visibility, and other metadata fields.
No binary data output is indicated.
Dependencies
- Requires valid YouTrack API credentials, either an API access token or OAuth2 credentials.
- The node expects the base URL of the YouTrack instance to be configured in the credentials.
- No additional external dependencies beyond the YouTrack API.
Troubleshooting
- Authentication errors: Ensure that the provided API token or OAuth2 credentials are valid and have sufficient permissions to create issues in the target project.
- Project not found: If the project ID or selection is incorrect or missing, the API will reject the request. Verify the project exists and is accessible.
- Required fields missing: The node requires at least the project, title, and description fields. Omitting these will cause errors.
- API rate limits or connectivity issues: Network problems or API throttling may cause failures; check network connectivity and API usage limits.
- Error messages typically include HTTP status codes and descriptive messages from YouTrack API; review these to adjust inputs or credentials accordingly.