In this tutorial you will learn to configure a Next Matter step that enables your process to automatically create JIRA tickets in your JIRA project.

Prerequisites:

Make sure that you know the key of your JIRA project. You will find this in your project overview in JIRA

Step 1: Create JIRA API token

Follow Atlassians official guide for creating API keys or check the below steps

https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/

Sign in to JIRA and Navigate to Settings --> Atlassian Account Settings

Select Security --> "Create and Manage API tokens" and create your API token. Note it down as you will not be able to access it again.

JIRA requires the authentication to be base64 encoded:

Build a string of the form useremail:api_token. so for example b.wayne@example.com:12345

BASE64 encode the string by using a tool like https://base64encode.org

Save the encoded string - you will need it in the next steps.

Step 2: Configure the Next Matter Step

Select the Next Matter process that should integrate with JIRA, open the editor and add a new Integration step or use the preconfigured step template at the right point in the process.

POST https://[YOUR_JIRA_SUBDOMAIN].atlassian.net/rest/api/latest/issue/

Headers:

Key             Value
Content-Type application/json
Authorization Basic [YOUR_API_KEY_FROM_STEP_1_ABOVE]

Sample Body:

{
"fields":{
"project": {
"key": "[YOUR_JIRA_PROJECT_KEY]"
},
"summary": "some summary",
"description": "some description",
"issuetype": {
"name": "some issue type. Usually Task or Bug"
}
}
}
  • The summary is oftentimes a data-reference from a previous step


Did this answer your question?