---
title: "Get started with Easy Integrations for Jira for Cloud"
canonical: "https://support.appfire.com/space/EIFJC/10125331/Get%20started%20with%20Easy%20Integrations%20for%20Jira%20for%20Cloud"
format: markdown
---
> Macro (aura-html)

Welcome to Easy Integrations for Jira Cloud, a powerful tool that allows you to effortlessly manage an unlimited number of integrations. This guide will walk you through the process of creating your first integration step by step, ensuring a smooth start to your integration journey.

## Step 1: Create a credential

Begin by establishing a credential, a vital step for authorizing your REST API integration. This step can be skipped if your REST API does not require authorization.

1. <span style="color: #000000">Navigate to </span><span style="color: #000000">**Apps**</span><span style="color: #000000"> > </span><span style="color: #000000">**Manage your apps**</span><span style="color: #000000"> > </span><span style="color: #202124">**Easy Integrations configuration**</span><span style="color: #202124"> > </span><span style="color: #202124">**Credentials**</span><span style="color: #202124">.</span>
2. <span style="color: #202124">Click </span><span style="color: #202124">**Create**</span><span style="color: #202124">.</span>
3. <span style="color: #202124">Provide a credential name. This name will be used later to select a credential while configuring an integration.</span>
4. <span style="color: #202124">Select the target </span><span style="color: #202124">**Authorization Type**</span><span style="color: #202124"> and fill in the required fills for the authorization type.</span>

---

## Step 2: Make an integration

<span style="color: #000000">After you have completed the credential for the authorization, you can create a Rest API integration.  </span>

1. <span style="color: #000000">Navigate to </span><span style="color: #000000">**Apps**</span><span style="color: #000000"> > </span><span style="color: #000000">**Manage your**</span><span style="color: #000000"> </span><span style="color: #000000">**apps**</span><span style="color: #000000"> > </span><span style="color: #202124">**Easy Integrations**</span><span style="color: #202124"> </span><span style="color: #202124">**configuration**</span><span style="color: #202124"> > </span><span style="color: #202124">**Listeners**</span><span style="color: #202124">.</span>
2. Click **Add listener**.
3. <span style="color: #202124">Give the listener a name.</span>
4. Click **Add event** and select the events to track (e.g., "Issue updated" and JQL: "issuetype = Task").
  - <span style="color: #172b4d">*Only a subset of JQL clauses is supported. Refer to *</span><span style="color: #172b4d">*[Listeners](https://appfire.atlassian.net/wiki/spaces/EIFJC/pages/10125382)*</span><span style="color: #172b4d">* and *</span>*[https://developer.atlassian.com/cloud/jira/platform/webhooks/#supported-jql-queries](https://developer.atlassian.com/cloud/jira/platform/webhooks/#supported-jql-queries)** for m*<span style="color: #172b4d">*ore information.*</span>
5. Click **Add action** and select **Call Rest API**.
6. <span style="color: #202124">Give the action a name.</span>
7. Write the action parameters script. Check out an example below:

**Action parameters:**

```javascript
var parameters = {};
parameters['issue summary'] = data.event.issue.fields.summary;
parameters['issue status'] = data.event.issue.fields.status.name;
return parameters;
```

8. Write the URL.
9. Select the HTTP Method.
10. Write headers. For example:

**Action parameters:**

```javascript
Accept=*/*
Cache-Control=no-cache
Content-Type=application/json
```

11. <span style="color: #000000">Select the </span><span style="color: #000000">**Authorization type**</span><span style="color: #000000"> and, if it's not </span><span style="color: #000000">*None*</span><span style="color: #000000">, select the </span><span style="color: #000000">**Credential**</span><span style="color: #000000">.</span>
12. Write the REST API body in JSON format<span style="color: #000000">. </span>Here's an example body, where {{issue summary}} and {{issue status}} are replaced by action parameters:

**Action parameters:**

```javascript
{
    "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
}
```

13. <span style="color: #000000">Click </span><span style="color: #000000">**OK**</span><span style="color: #000000"> to add the action.</span>
14. <span style="color: #000000">Click </span><span style="color: #000000">**Submit**</span><span style="color: #000000"> to save the Listener.</span>

Now it's time to update an issue! Please note that the issue must be of the Task issue type. To observe what happened, you can <span style="color: #000000">navigate to </span><span style="color: #000000">**Apps**</span><span style="color: #000000"> > </span><span style="color: #000000">**Manage your apps**</span><span style="color: #000000"> > </span><span style="color: #202124">**Easy Integrations configuration**</span><span style="color: #202124"> > </span><span style="color: #202124">**Execution Logs**</span><span style="color: #202124">. Happy integrating!</span>