Get Started

Easy Integrations for JIRA Cloud offers everything you need to manage an unlimited number of integrations. Follow the steps in this section to start creating your first integration with ease!

Let's create a new REST API integration.

Step 1 - Create a Credential

You can skip this if the rest API does not require an authorization method.

  • Navigate to Apps > Manage your apps > Easy Integrations configuration > Credentials.
  • Click "Create"
  • Give a credential name (this name will be used later to select a credential while configuring an integration).
  • Select the target "Authorization Type" and fill in the required fills for the authorization type.

Step 2 - Make an Integration

After you have completed the credential for the authorization, you can create a Rest API integration.  

  • Navigate to Apps > Manage your apps > Easy Integrations configuration > Listeners.
  • Click "Add listener"
  • Give a listener name
  • Click "Add event" and select the events to track. e.g.: "Issue updated" and JQL: "issuetype = Task"
  • Click "Add action" and select "Call Rest API"
  • Give an action name
  • Write action parameters script, e.g:
Action parameters
var parameters = {};
parameters['issue summary'] = data.event.issue.fields.summary;
parameters['issue status'] = data.event.issue.fields.status.name;
return parameters;
  • Write URL
  • Select HTTP Method
  • Write headers
Action parameters
Accept=*/*
Cache-Control=no-cache
Content-Type=application/json
  • Select the "Authorization type" and if it's not None, select the Credential
  • Write Rest API body JSON.

Below is an example body, {{issue summary}} and {{issue status}} are replaced by action parameters.

Action parameters
{
    "name": "{{issue summary}}",
    "attributes": [
        {
            "attributeId": "41",
            "attributeValue": "{{issue status}}"
        },
        {
            "attributeId": "121",
            "attributeValue": 12.5
        }
    ],
    "systemFields": [
        {
            "fieldName": "asset.status",
            "value": "1"
        },
        {
            "fieldName": "asset.substatus",
            "value": "1"
        }
    ],
    "formId": 148,
    "attachments": null
}
  • Click Ok to add action
  • Click Submit so save Listener
  • Now it's time to update an issue. Please remember that the issue must be a Task issue-type.
  • Navigate to Apps > Manage your apps > Easy Integrations configuration > "Execution Logs" to observe what has happened.