> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Issue

Creates a new issue.

<Note>
  External Documentation

  To learn more, visit the [Jira documentation](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/#api-rest-api-3-issue-post).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter        | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
  | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | ADF Description  | The ADF-formatted description of the issue.<br /><br />**Example:** <br /><pre><code>\{<br />    "type": "doc",<br />    "version": 1,<br />    "content": \[<br />      \{<br />        "type": "paragraph",<br />        "content": \[<br />          \{ "type": "text", "text": "This is " },<br />          \{ "type": "text", "text": "important", "marks": \[\{ "type": "strong" }] },<br />          \{ "type": "text", "text": " information." }<br />        ]<br />      }<br />    ]<br />}</code></pre>For more information on ADF please visit [Atlassian's Documentation](https://developer.atlassian.com/cloud/jira/platform/apis/document/structure/). |
  | Assignee Email   | The email address or the display name of the assignee. The string can match the prefix of the attribute's value.<br />For example, query=john matches a user with a displayName of John Smith and a user with an emailAddress of [johnson@example.com](mailto:johnson@example.com).<br />Therefore, it's recommended to use the user's email to prevent the string from matching multiple values, which is ambiguous and will cause the action to fail.                                                                                                                                                                                                                |
  | Description      | Description of the issue.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
  | Description Type | Select the format for your description content - text or ADF (Atlassian Document Format).<br /><br />For more information on ADF, please visit [Atlassian's Documentation](https://developer.atlassian.com/cloud/jira/platform/apis/document/structure/).                                                                                                                                                                                                                                                                                                                                                                                                              |
  | Issue Type       | The type of the issue. The type must be defined in your Jira workspace.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
  | Project Key      | The project's key.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
  | Reporter Email   | The email address or the display name of the reporter. The string can match the prefix of the attribute's value.<br />For example, query=john matches a user with a displayName of John Smith and a user with an emailAddress of [johnson@example.com](mailto:johnson@example.com).<br />Therefore, it's recommended to use the user's email to prevent the string from matching multiple values, which is ambiguous and will cause the action to fail.                                                                                                                                                                                                                |
  | Summary          | Summary of the issue.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter     | Description                                                                                                                                                                                                                                                                                                            |
  | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Components    | A list of Components that need to be set up in the new issue.<br /><br />Example input:<br /><pre><code>\[<br />  \{<br />    "id": "10000"<br />  },<br />  \{<br />    "name": "Component 1"<br />  }<br />]</code></pre>                                                                                            |
  | Custom Fields | Custom fields in JSON form, where the key is the *name* of the custom field mapped to its value.<br /><br />Example input:<br /><pre><code>\{<br />  "foobar": 10,<br />  "incident\_status": "resolved"<br />}</code></pre><br />Will set the custom field named "foobar" to 10 and "incident\_status" to "resolved". |
  | Labels        | A comma separated list of labels for the issue.                                                                                                                                                                                                                                                                        |
  | Transition    | Details of a transition. Required when performing a transition, optional when creating or editing an issue.<br /><br />Example input:<br /><pre><code>\{<br />  "id": `"<string>"`,<br />  "looped": true<br />}</code></pre>                                                                                          |
</div>

## Example Output

```json theme={"dark"}
{
	"id": "10009",
	"key": "TEST-10",
	"self": "https://example.org"
}
```

## Workflow Library Example

[Create an Amazon S3 Bucket with an Approval and Audit Process](https://library.blinkops.com/workflows/create-an-amazon-s3-bucket-with-an-approval-and-audit-process)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/create-an-amazon-s3-bucket-with-an-approval-and-audit-process/canvas" />
</div>