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