Jira Data Center icon

Jira Data Center

Interact with Jira Data Center API

Actions16

Issue → Create

AI-generated

Overview

This node integrates with the Jira Data Center API to manage issues within Jira projects. Specifically, the "Issue - Create" operation allows users to create new issues in a specified Jira project by providing essential details such as the project key, issue type, summary, and description.

Common scenarios where this node is beneficial include:

  • Automating issue creation from external systems or forms.
  • Integrating Jira issue tracking into custom workflows.
  • Quickly logging bugs, tasks, or feature requests programmatically.

For example, a development team could use this node to automatically create Jira issues when errors are detected in their application monitoring system, ensuring that all problems are tracked and assigned for resolution.

Properties

Name Meaning
Authentication Method of authentication: "Personal Access Token" or "Basic Auth".
Project The Jira project key where the issue will be created.
Issue Type The type/category of the issue (e.g., Bug, Task, Story).
Summary The title or brief summary of the issue.
Description A detailed description of the issue.

Output

The output JSON contains the response from the Jira API after creating an issue. This typically includes the newly created issue's metadata such as its unique key, ID, self URL, and other relevant fields returned by Jira.

No binary data is output by this operation.

Example output snippet (simplified):

{
  "id": "10001",
  "key": "PROJ-123",
  "self": "https://your-jira-instance/rest/api/2/issue/10001"
}

Dependencies

  • Requires access to a Jira Data Center instance.
  • Needs either a Personal Access Token or Basic Authentication credentials configured in n8n.
  • The node uses Jira REST API endpoints under /rest/api/2/.

Troubleshooting

  • Authentication Errors: Ensure that the provided API token or basic auth credentials are valid and have sufficient permissions to create issues in the target project.
  • Invalid Project Key or Issue Type: Verify that the project key and issue type exist in your Jira instance. Use the node’s options loading features to select valid values.
  • Missing Required Fields: The summary and project key are required; missing these will cause errors.
  • API Request Failures: Network issues or Jira server downtime can cause request failures. Check connectivity and Jira server status.
  • Error Messages: Errors from the Jira API are wrapped and presented with messages like Jira Data Center API request failed: <error message>. Review the error message for specifics.

Links and References

Discussion