create_issue
Create new Jira issues with required fields like project key, summary, and issue type. Supports optional fields including description, priority, assignee, labels, and custom fields for comprehensive issue tracking.
Instructions
Create a new Jira issue with specified fields. IMPORTANT: Always use get_create_metadata first to discover required fields, custom fields, and allowed values for the project and issue type.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| assignee | No | Assignee account ID or email (will auto-lookup account ID from email) - optional | |
| customFields | No | Custom fields as key-value pairs (e.g., {"customfield_10000": "value"}) - optional. Use get_create_metadata to discover available fields. | |
| description | No | The issue description in Atlassian Document Format (ADF). Can be a simple string for plain text, or an ADF object for rich formatting. Example ADF: {"type":"doc","version":1,"content":[{"type":"paragraph","content":[{"type":"text","text":"Description text"}]}]} | |
| issueType | Yes | The issue type (e.g., Bug, Task, Story) | |
| labels | No | Array of labels - optional | |
| priority | No | Priority name (e.g., High, Medium, Low) - optional | |
| projectKey | Yes | The project key where the issue will be created (e.g., PROJ, DEV) | |
| summary | Yes | The issue summary/title |
Input Schema (JSON Schema)
{
"properties": {
"assignee": {
"description": "Assignee account ID or email (will auto-lookup account ID from email) - optional",
"type": "string"
},
"customFields": {
"description": "Custom fields as key-value pairs (e.g., {\"customfield_10000\": \"value\"}) - optional. Use get_create_metadata to discover available fields.",
"type": "object"
},
"description": {
"description": "The issue description in Atlassian Document Format (ADF). Can be a simple string for plain text, or an ADF object for rich formatting. Example ADF: {\"type\":\"doc\",\"version\":1,\"content\":[{\"type\":\"paragraph\",\"content\":[{\"type\":\"text\",\"text\":\"Description text\"}]}]}"
},
"issueType": {
"description": "The issue type (e.g., Bug, Task, Story)",
"type": "string"
},
"labels": {
"description": "Array of labels - optional",
"items": {
"type": "string"
},
"type": "array"
},
"priority": {
"description": "Priority name (e.g., High, Medium, Low) - optional",
"type": "string"
},
"projectKey": {
"description": "The project key where the issue will be created (e.g., PROJ, DEV)",
"type": "string"
},
"summary": {
"description": "The issue summary/title",
"type": "string"
}
},
"required": [
"projectKey",
"summary",
"issueType"
],
"type": "object"
}