---
title: Jira Cloud Platform
description: "Jira Cloud platform provides a set of base functionality shared across all Jira products, such as issues, users, assets, and more. Jira products are built on top of the Jira Cloud platform. Currently, Lucidum supports users and assets connectors. ##…"
url: "https://lucidum.io/docs/jira-cloud-platform/"
updated: "2024-06-29"
category: Connectors / List of Connectors / J
---

# Jira Cloud Platform

Jira Cloud platform provides a set of base functionality shared across all Jira products, such as issues, users, assets, and more. Jira products are built on top of the Jira Cloud platform. Currently, Lucidum supports users and assets connectors.

## Creating an API Key for Jira

Before configuring the Jira connector in Lucidum, you must first create an API Key. Lucidum will use the API key to access the Jira API.

To integrate Lucidum with Jira, you need to do the following :

1. Create a user in your Atlassian site with access to Jira. This user must have global Jira administrators permission. For details, see [https://confluence.atlassian.com/adminjiraserver/managing-global-permissions-938847142.html](https://confluence.atlassian.com/adminjiraserver/managing-global-permissions-938847142.html)
2. Log in to Jira using the created user and generate an API token. For cloud-based Atlassian sites, use the following URL to generate an API token: [https://id.atlassian.com/manage/api-tokens#](https://id.atlassian.com/manage/api-tokens#)

## Configuring the Connector for Jira

To configure Lucidum to ingest data from Jira:

1. Log in to Lucidum.
2. In the left pane, click **Connector**.
3. In the **Connector** page, click **Add Connector**.
4. Scroll until you find the Connector you want to configure. Click **Connect**. The **Settings** page appears.
5. In the **Settings** page, enter the following:

   - **URL** *(required). *The base URL of the Jira Cloud Platform REST API. For example, https://[lucidum.atlassian.net](http://adroll.atlassian.net/).
   - ***User Name***. User name for a Jira account that has global Jira administrators permission.

     **NOTE**: This user must have global Jira administrators permission. For details, see [https://confluence.atlassian.com/adminjiraserver/managing-global-permissions-938847142.html](https://confluence.atlassian.com/adminjiraserver/managing-global-permissions-938847142.html)

     **NOTE**: If your organization requires more granular permissions, please contact your Lucidum Customer Success representative to help you with the required Jira permission.
   - ***API Token. ***An API Token associated with the user account specified in ***User Name***.

     **NOTE**: Jira provides both an API Key and an API Token. ***Lucidum uses only the API Token.***
6. To test the configuration, click **Test**.

   - If the connector is configured correctly, Lucidum displays a list of services that are accessible with the connector.
   - If the connector is not configured correctly, Lucidum displays an error message.

## API Documentation

[https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-users/#api-group-users](https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-users/#api-group-users)

[https://developer.atlassian.com/cloud/assetsapi/rest/api-group-assets/#api-asset-get](https://developer.atlassian.com/cloud/assetsapi/rest/api-group-assets/#api-asset-get)

[https://developer.atlassian.com/cloud/assets/assets-rest-api-guide/workflow/#assets-rest-api-guide](https://developer.atlassian.com/cloud/assets/assets-rest-api-guide/workflow/#assets-rest-api-guide)
