---
name: tracker/jira-official:issue-create
description: Create a new JIRA issue
version: "0.5.0"
---

# Issue Create

> **Backend:** jira-official (atlassian@claude-plugins-official)

> **Note:** Requires `atlassian@claude-plugins-official` plugin. Install: `/plugin install atlassian@claude-plugins-official`

Creates a new JIRA issue of the specified type within a project.

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| project_key | string | Yes | JIRA project key (e.g., `<PROJECT_KEY>`) |
| issue_type | string | Yes | Type of issue: `Story`, `Task`, `Bug`, or `Epic` |
| summary | string | Yes | Issue title/summary |
| description | string | No | Issue description |
| labels | array | No | Array of label strings to apply |
| parent_key | string | No | Parent issue key (required for subtasks) |
| assignee_id | string | No | Atlassian account ID of assignee (from `project-constants.md` `ASSIGNEE_ID`) |

## Implementation

Uses MCP JIRA tool: `mcp__atlassian__createJiraIssue`

```
mcp__atlassian__createJiraIssue({
  project_key: "<project_key>",
  issue_type: "<issue_type>",
  summary: "<summary>",
  description: "<description>",
  labels: ["<label>"],
  parent_key: "<parent_key>",
  assignee_id: "<assignee_id>"
})
```

## Output

| Field | Type | Description |
|-------|------|-------------|
| key | string | New issue key (e.g., `<PROJECT_KEY>-123`) |
| id | string | Internal JIRA issue ID |
| self | string | REST API URL for the created issue |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| 404 | Project key not found | Verify the project key matches the JIRA project |
| 403 | Insufficient permissions to create issues | Confirm the JIRA user has create permissions on the project |
| 400 | Missing required field (`summary` or `issue_type`) | Ensure both fields are provided and non-empty |
| 400 | Invalid `issue_type` value | Use one of: `Story`, `Task`, `Bug`, `Epic` |
| 400 | Invalid `assignee_id` | Verify the Atlassian account ID in `project-constants.md` |
| 400 | Invalid `parent_key` for issue type | Subtask `parent_key` must reference a valid parent issue |
| MCP | Plugin unavailable | Verify the `atlassian@claude-plugins-official` plugin is installed and connected |

## Used By

- design-feature (creating stories and tasks during feature planning)
- dev-task (creating subtasks or bug reports during development)
