# Create Jira issue comment

Canonical URL: https://docs.fuse.init.inc/integrations/jira/actions/comments.create

Create a Jira issue comment with bounded Atlassian Document Format.

Action ID: `comments.create`
Provider: Jira (`jira`)
Contract version: 1

## Risk and exposure

- Risk: Write
- Idempotency: Unsafe — Retries may duplicate side effects; callers must coordinate carefully.
- Availability: Default
- Exposure: REST, SDK, MCP
- MCP hints: readOnly=false, destructive=false, idempotent=false, openWorld=true

## Required scopes

- `write:jira-work`
- `offline_access`

## Input schema fields

- `issue_id_or_key`
- `body`
- `body.type`
- `body.version`
- `body.content`
- `body.content[]`
- `body.content[].type`
- `body.content[].attrs`
- `body.content[].attrs.level`
- `body.content[].content`
- `body.content[].content[]`
- `body.content[].content[].type`
- `body.content[].content[].text`
- `body.content[].content[].marks`
- `body.content[].content[].marks[]`
- `body.content[].content[].marks[].type`
- `body.content[].content[].marks[].attrs`
- `body.content[].content[].marks[].attrs.href`
- `body.content[].content[].attrs`
- `body.content[].content[].attrs.level`
- `body.content[].content[].content`
- `body.content[].content[].content[]`
- `body.content[].content[].content[].type`
- `body.content[].content[].content[].text`
- `body.content[].content[].content[].marks`
- `body.content[].content[].content[].marks[]`
- `body.content[].content[].content[].marks[].type`
- `body.content[].content[].content[].marks[].attrs`
- `body.content[].content[].content[].marks[].attrs.href`
- `body.content[].content[].content[].attrs`
- `body.content[].content[].content[].attrs.level`
- `body.content[].content[].content[].content`
- `body.content[].content[].content[].content[]`
- `body.content[].content[].content[].content[].type`
- `body.content[].content[].content[].content[].text`
- `body.content[].content[].content[].content[].marks`
- `body.content[].content[].content[].content[].marks[]`
- `body.content[].content[].content[].content[].marks[].type`
- `body.content[].content[].content[].content[].marks[].attrs`
- `body.content[].content[].content[].content[].marks[].attrs.href`

## Output schema fields

- `id`
- `body`
- `body.type`
- `body.version`
- `body.content`
- `body.content[]`
- `body.content[].type`
- `body.content[].attrs`
- `body.content[].attrs.level`
- `body.content[].content`
- `body.content[].content[]`
- `body.content[].content[].type`
- `body.content[].content[].text`
- `body.content[].content[].marks`
- `body.content[].content[].marks[]`
- `body.content[].content[].marks[].type`
- `body.content[].content[].marks[].attrs`
- `body.content[].content[].marks[].attrs.href`
- `body.content[].content[].attrs`
- `body.content[].content[].attrs.level`
- `body.content[].content[].content`
- `body.content[].content[].content[]`
- `body.content[].content[].content[].type`
- `body.content[].content[].content[].text`
- `body.content[].content[].content[].marks`
- `body.content[].content[].content[].marks[]`
- `body.content[].content[].content[].marks[].type`
- `body.content[].content[].content[].marks[].attrs`
- `body.content[].content[].content[].marks[].attrs.href`
- `body.content[].content[].content[].attrs`
- `body.content[].content[].content[].attrs.level`
- `body.content[].content[].content[].content`
- `body.content[].content[].content[].content[]`
- `body.content[].content[].content[].content[].type`
- `body.content[].content[].content[].content[].text`
- `body.content[].content[].content[].content[].marks`
- `body.content[].content[].content[].content[].marks[]`
- `body.content[].content[].content[].content[].marks[].type`
- `body.content[].content[].content[].content[].marks[].attrs`
- `body.content[].content[].content[].content[].marks[].attrs.href`
- `author`
- `author.account_id`
- `author.display_name`
- `author.active`
- `created`
- `updated`

Provider overview: https://docs.fuse.init.inc/integrations/jira
Actions index: https://docs.fuse.init.inc/integrations/jira/actions
Exact canonical JSON contract: https://docs.fuse.init.inc/api/catalog/v1/providers/jira/actions/comments.create
Deployment-effective discovery: https://api.fuse.init.inc/v1/tenants/%7Btenant_id%7D/providers/jira/actions
