jira_create_issue
Create new Jira issues with detailed specifications including project, issue type, priority, assignee, and custom fields. Automatically formats plain text descriptions to structured ADF format with headings and lists.
Instructions
Creates a new Jira issue in the specified project. Supports setting issue type, priority, assignee, labels, components, and custom fields. Description accepts plain text and is auto-formatted to ADF: lines ending with ":" become headings, numbered lines create ordered lists, and URLs are linkified. For required custom fields, supply them via customFields (e.g., { "customfield_12345": { id: "..." } }). Returns the created issue with all details.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| assignee | No | Assignee account ID (optional) | |
| components | No | Component names (optional) | |
| customFields | No | Additional Jira fields, e.g. { "customfield_10071": value }. Use this to set required custom fields. | |
| description | No | Detailed issue description (optional). Accepts plain text (auto-formatted to ADF) or an ADF document. | |
| issueType | Yes | Issue type name (e.g., Bug, Story, Task, Epic) | |
| labels | No | Issue labels (optional) | |
| priority | No | Issue priority name (e.g., High, Medium, Low) - optional | |
| projectKey | Yes | Project key where the issue will be created | |
| returnIssue | No | If false, returns only the issue key without fetching full details | |
| summary | Yes | Issue summary/title |
Input Schema (JSON Schema)
{
"properties": {
"assignee": {
"description": "Assignee account ID (optional)",
"type": "string"
},
"components": {
"default": [],
"description": "Component names (optional)",
"items": {
"type": "string"
},
"type": "array"
},
"customFields": {
"additionalProperties": true,
"description": "Additional Jira fields, e.g. { \"customfield_10071\": value }. Use this to set required custom fields.",
"type": "object"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "object"
}
],
"description": "Detailed issue description (optional). Accepts plain text (auto-formatted to ADF) or an ADF document."
},
"issueType": {
"description": "Issue type name (e.g., Bug, Story, Task, Epic)",
"type": "string"
},
"labels": {
"default": [],
"description": "Issue labels (optional)",
"items": {
"type": "string"
},
"type": "array"
},
"priority": {
"description": "Issue priority name (e.g., High, Medium, Low) - optional",
"type": "string"
},
"projectKey": {
"description": "Project key where the issue will be created",
"type": "string"
},
"returnIssue": {
"default": true,
"description": "If false, returns only the issue key without fetching full details",
"type": "boolean"
},
"summary": {
"description": "Issue summary/title",
"minLength": 1,
"type": "string"
}
},
"required": [
"projectKey",
"summary",
"issueType"
],
"type": "object"
}