# Jira Cloud Integration

## 1. **Generate Jira Cloud API Token**

1. Click on the **profile** picture at the top right of the screen, then select **Account Settings**. 

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FbJT79Dk5G6ERsBMk17Ej%2Ffile.png?alt=media)

2\. Open the "Security" tab.

![Select Security tab.](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FdnJTMy2uk35njnI22hpk%2Ffile.png?alt=media)

3\. Click the link "**Create and manage API tokens**" under the API Token section.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2F0mpsKeUqc89JaOJOoVZv%2Ffile.png?alt=media)

4\. Click the "**Create API token**" button at the top of the page. 

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FqZ6Picd6fsSSIkqAHn4w%2Ffile.png?alt=media)

5\. Fill out the Label area as you prefer. Make sure you copy your new API token for further use.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FEuLLcCx1qMA0ZqFq48S7%2Ffile.png?alt=media)

## **2. Install Jira Addon on Oobeya** :jigsaw: 

1. Log in to [Oobeya](https://oobeya.io/) with an *Administrator* account.
2. Navigate to **Integrations** and select the **Jira** addon and then click the **"Install"** button.

![](https://3582076375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FwkLN7Xu9VT4h78rQSlBt%2FScreenshot%202024-12-17%20at%2013.37.58.png?alt=media\&token=ac82c855-2d14-4bc8-a4e1-30c9d9762f08)

## **3. Add A New Data Source** :electric\_plug: 

1\. Navigate to **Data Sources**, select Jira to add a new data source. 

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2F2RNvEaQB5JJsMdfJKp6G%2Ffile.png?alt=media)

2\. Click the **"New Data Source"** button and fill in the form.

* **Server URL:** Enter your Jira Cloud account URL (e.g. <https://yourcompany.atlassian.net>)
* **Username:** Enter the email address registered on Jira Cloud.
* **Password:** Enter the API Token which was created on Jira settings in the first step.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MGIlBSTjQtZxUoFwUx4%2Fuploads%2FGJWsJ31zrtTHKbIyxRDG%2Ffile.png?alt=media)

3. Click the **"Test Connection"** button to verify the connection.

&#x20;4\. Select the **"Set as default"** option to provide a default data source for the Scorecards.

## **Ready to Connect** :rocket:&#x20;

Now Oobeya is connected with your own Jira Cloud account to get the real-time project management data of your organization.

## **Next Steps** :dart:&#x20;

* [Add a new Widget](https://docs.oobeya.io/dashboards/adding-a-new-widget)