--- title: "JIRA" slug: "jira" description: "Get the most out of your JIRA data with Dataddo. Create safe, reliable, and secure data pipelines in just a few minutes and send data to any destination." tags: ["Fixed-schema connector", "How-to guide", "Data source"] updated: 2023-11-21T15:43:50Z published: 2023-11-21T15:43:50Z --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.dataddo.com/llms.txt > Use this file to discover all available pages before exploring further. # JIRA **JIRA** is a project management tool primarily used for issue tracking, task management, and agile project planning. It enables teams to organize, track, and manage various types of work, such as software development tasks, IT operations, and service desk support. Refer to our website for [the list of metrics and attributes available in Dataddo](https://www.dataddo.com/connector/jira). ## Authorize Connection to JIRA There are three different ways to authorize your JIRA account in Dataddo. Please see the following matrix to choose the method most suitable for your case. | Method | Requirements | Use Case | | --- | --- | --- | | [JIRA](/docs/jira#jira-connector) | Subdomain name of Jira Cloud | For Jira Cloud; OAuth authentication without credential sharing | | [JIRA PAT](/docs/jira#jira-pat-connector) | Domain name and Personal Access Token (PAT) | For Jira Cloud with controlled access; secure with revocable, limited-permission PATs | | [JIRA Server](/docs/jira#jira-server-connector) | Hostname, username, password of Jira Server | For self-hosted Jira Server; direct credential sharing with minimal permissions | ### JIRA Connector #### In JIRA To authorize your JIRA account, you will need your **subdomain name**. 1. Connect and log in to your JIRA cloud instance. 2. The URL in your browser will be in this format `my-jira-subdomain.atlassian.net`. 3. Copy the subdomain name (in this case `my-jira-subdomain`) to provide to Dataddo. #### In Dataddo 1. On the **Authorizers** page, click on [Authorize New Service](https://app.dataddo.com/service/new) and select JIRA. 2. Fill in your **subdomain name**. In this example, it will be `my-jira-subdomain`. 3. Rename your ***authorizer*** for easier identification and click on **Save**. ### JIRA PAT Connector #### In JIRA To authorize your JIRA account using a personal access token, you will need your **domain name** and a **personal access token (PAT)**. 1. Connect and log in to your JIRA cloud instance. 2. The URL in your browser will be in this format `my-jira-subdomain.atlassian.net`. Subdomain name is `my-jira-subdomain`. 3. To obtain your **PAT**, follow these steps: 1. Click on your profile picture and select **Settings**. 2. Navigate to the **Personal Access Tokens** section and click on **Create token**. 3. Name your token and click on **Create**. 4. Copy the value to provide to Dataddo. #### In Dataddo 1. On the **Authorizers** page, click on [Authorize New Service](https://app.dataddo.com/service/new) and select JIRA PAT. 2. Fill in the following fields 1. **Domain name**: Fill in your subdomain name. In this example, it will be `my-jira-subdomain`. 2. **PAT**: Insert the personal access token. 3. Rename your ***authorizer*** for easier identification and click on **Save**. ### JIRA Server Connector #### In JIRA To authorize connection to your self-hosted JIRA instance, you will need your **server hostname**, **username**, and **password**. Please keep in mind that we only support connection via https://. If you are using cloud JIRA, please use the other authorizer. 1. Connect and log in to your JIRA cloud instance. 2. The URL in your browser will be in this format `my-jira-subdomain.atlassian.net`. 3. Copy the server hostname (`my-jira-subdomain`) to provide to Dataddo. #### In Dataddo 1. On the **Authorizers** page, click on [Authorize New Service](https://app.dataddo.com/service/new) and select JIRA Server. 2. Fill in the following fields 1. **Domain name**: Your subdomain name, in this example, it will be `my-jira-subdomain`. 2. **Username**: Your JIRA username. 3. **Passwrod**: Your JIRA password. 3. Rename your ***authorizer*** for easier identification and click on **Save**. ## How to Create a JIRA Data Source 1. On the **Sources** page, click on the [**Create Source**](https://app.dataddo.com/sources/new) button. 2. Select the connector from the list and name your ***data source***. 3. On the **Dataset** step, select your **dataset**. **DATADDO TIP** If you're unsure which dataset to select, use the search bar to look for datasets with the desired attributes or metrics. 4. On the **Account** step select your ***authorizer*** from the drop-down menu. **Didn't find your authorizer?** Click on **Add new Account** at the bottom of the drop-down and follow the on-screen prompts. You can also go to the **Authorizers** tab and click on [**Add New Service**](https://app.dataddo.com/service/new). 5. On the **Attributes and Metrics** step, select the **metrics and attributes** you want to extract. ![Create a source using a custom-schema connector.](https://cdn.document360.io/084ed225-3f99-4644-a2da-39ca0cd5ef45/Images/Documentation/Create%20Source%20-%20Custom-Schema%20Connector.png) 6. On the **Metadata** step, select which [**metadata fields**](/docs/metadata-inclusion) such as extraction time to add to your data. 7. On the **Snapshot** step: 1. Configure your [**sync frequency**](/docs/extraction#extraction-frequency) or click **Show advanced settings** to set the exact synchronization time. **DATADDO TIP** To **load historical data**, refer to the [**Data Backfilling**](https://docs.dataddo.com/docs/data-backfilling) article. 2. [Optional] Enable the **Allow Empty Data Extractions** toggle to allow the extraction when no data is available. 8. In the top-right corner, click **Test Data** button to preview extracted data. **Adjust the date range** for specific time frame. 9. Click on **Save** and **congratulations, your new data source is ready!** --- ## Troubleshooting ### Data Preview Unavailable No data preview when you click on **Test Data** might be caused by an issue with your ***source*** configuration. The most common causes are: - **Date range**: Try a smaller date range. You can load the rest of your data afterward via [manual data load](https://docs.dataddo.com/docs/data-backfilling). - **Insufficient permissions**: Please make sure your authorized account has at least admin-level permissions. ## Related Articles Now that you have successfully created a ***data source***, see how you can connect your data to a dashboarding app or a data storage. **Sending Data to Dashboarding Apps** - [Simple Data Integration to Dashboards](https://docs.dataddo.com/docs/simple-data-integration-to-dashboards) - [Data Backfilling to Dashboarding Apps](https://docs.dataddo.com/docs/data-backfilling-to-dashboarding-apps) **Sending Data to Data Storages** - [Batch Ingestion to Data Warehouses](https://docs.dataddo.com/docs/ingestion-to-data-warehouses) - [Data Backfilling to Storages](https://docs.dataddo.com/docs/data-backfilling-to-storages) **Other Resources** - [Troubleshooting](https://docs.dataddo.com/docs/troubleshooting) - [Extraction Logs](https://docs.dataddo.com/docs/extraction-logs) - [Data Duplication](https://docs.dataddo.com/docs/data-duplication) Authorizers act as credentials for external services (e.g. Facebook or Google). To enable Dataddo to access and retrieve your data, you need to grant access to accounts that possess admin-level permissions or higher within these services.