Create a Jira issue from Postman

Once you connect your Jira account to your Postman account, you can create a new Jira issue from an HTTP collection, collection run, or response in Postman. You can also link to an existing issue.

With Jira and Postman, you can see the status of all open issues, track your project’s status, and assess your API’s performance, all from Postman.

Create a Jira issue from a collection, collection run, or response

If there’s an issue with your HTTP collection, collection run, or one of your HTTP responses, you can create a new Jira issue from Postman.

To create a Jira issue from a collection, collection run, or response, do the following:

1. Open an HTTP collection or request. Then, open the collection’s known issues, run the collection, or send the request:

   • To open the collection’s known issues, under Known issues, click the number of issues.
   • To run the collection, click Run, set up the run, and run it. To learn more, see Test your API using the Collection Runner.
   • To send the request, click Send.

2. Open the Jira form:

   • From a collection’s known issues, click New. Postman prompts you to create a new issue or link to an existing one.
   • From the collection run or response pane, click View more actions. Then, click Add to Jira Cloud. Postman prompts you to create a new issue or link to an existing one.

3. Select a Jira site and project. To search for a project, start typing its name.

4. Select a work type. Postman displays any required and optional fields.

5. Edit the summary and (optional) description.

6. (Optional) If you sent a request, choose to include the response in the issue.

7. Select an assignee. To search for an assignee, start typing their name.

8. Complete any required fields. (Optional) Then, complete any optional fields. To see the optional fields, click ‌Show optional fields.

9. Click Create Issue.

Postman creates a new Jira issue for you and links it to your collection, collection run, or response. When you view your issue’s description in Jira, you’ll see a link to your collection, collection run, or response in Postman.

You can also view all issues linked to your request and all issues linked to your collection.

Link to an existing Jira issue from a collection, collection run, or response

If there’s an issue with your HTTP collection, collection run, or one of your HTTP responses, you can link to an existing Jira issue from Postman.

To link to an existing Jira issue from a collection, collection run, or response, do the following:

1. Open an HTTP collection or request. Then, open the collection’s known issues, run the collection, or send the request:

   • To open the collection’s known issues, under Known issues, click the number of issues.
   • To run the collection, click Run, set up the run, and run it. To learn more, see Test your API using the Collection Runner.
   • To send the request, click Send.

2. Open the Jira form:

   • From a collection’s known issues, click New. Postman prompts you to create a new issue or link to an existing one.
   • From the collection run or response pane, click View more actions. Then, click Add to Jira Cloud. Postman prompts you to create a new issue or link to an existing one.

3. Under Select option, select Connect existing issue.

4. Select a Jira site and project. To search for a project, start typing its name.

5. Select an issue. To search for an issue, start typing its name. You can also paste a link to an issue.

6. (Optional) Edit the comment.

7. (Optional) If you sent a request, choose to include the response in the issue.

8. Click Connect Issue.

Postman links your existing Jira issue to your collection, collection run, or response. When you view your issue’s description in Jira, you’ll see a link to your collection, collection run, or response in Postman.

You can also view all issues linked to your request and all issues linked to your collection and collection runs.