Jira Events

Cloud Elements currently supports events via polling or webhooks depending on the endpoint.

  • Polling is a mechanism where Cloud Elements executes the configured query every n minutes and captures the changed information.
  • Webhooks are when the provider lets Cloud Elements know what information has changed. Note that additional endpoint setup may be required prior to creating your element instance.
Note: Cloud Elements normalizes only the objectId, objectType, and eventType event data. Event data also contains raw data, which the provider returns. The raw data varies based on the endpoint.

If you would like to see more information on our Events framework, please see Events Overview.

JIRA requires an extra configurations to the endpoint in order to enable webhooks.

Step 1. Endpoint setup

Login to your Jira Development Account

  1. Click Settings JIRA Wehhook Setup step 1

  2. Click "System" JIRA Wehhook Setup step 2

  3. Scroll Down and find WebHooks on the left hand side navigation panel

  4. Click “WebHooks” JIRA Wehhook Setup step 3

  5. Click ” + Create a WebHook” JIRA Wehhook Setup step 4

  6. Name the WebHook

  7. Make sure “Enabled” is selected

  8. Input this URL: https://api.cloud-elements.com/elements/api-v2/events/jira JIRA Wehhook Setup step 5

From this point, your webhook will receive all possible event notifications from every project.

Customization options are available. View the next screen shot for those options.

If you wish to have your WebHook receive all possible event notifications, then scroll down and click “Create”.

Optional Customization Features

Here you have the option to customize the type of events you wish your app to listen for. For example, setting a specific project to receive event notifications, as well as, setting specific events.

  • Option to set specific projects to receive event notifications

  • Option to set event specific notifications

  • Click “Create”. JIRA Wehhook Setup step 6

To provision your JIRA element with webhooks enabled, use the following JSON when calling the /instances API.

{
  "element": {
    "key": "jira"
  },
  "configuration": {
    "jira.username": "<INSERT_JIRA_USERNAME>",
    "jira.password": "<INSERT_JIRA_PASSWORD>",
    "jira.api.url": "<INSERT_JIRA_SUBDOMAIN_URL>",
    "event.notification.enabled": "true",
    "event.notification.callback.url": "<INSERT_YOUR_APPS_CALLBACK_URL>"
  },
  "tags": [
    "<INSERT_TAGS>"
  ],
  "name": "<INSERT_INSTANCE_NAME>"
}