> For the complete documentation index, see [llms.txt](https://thecode4.gitbook.io/thecode4-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://thecode4.gitbook.io/thecode4-docs/user-guide/generate-access-tokens/create-jira-api-token.md).

# Create Jira API Token

Due to security measures, **each user must individually create** their Access Token, which acts like a password. Jira **Administrators** are **not authorized** to create Access Tokens **on behalf** of other users.

***

### To obtain an **API Token**, please follow these steps:

1. Visit Atlassian [API Tokens](https://id.atlassian.com/manage/api-tokens).

   \
   If you're not logged into your **Atlassian Account**, you'll need to **sign in** first. After logging in, navigate to the '**Security**' section and then proceed to '**Create and manage API tokens**' to continue with your task.<br>

   <div><figure><img src="https://3783386375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbAZwNh39hWp69xdDNc6%2Fuploads%2F3vfrBlWgZk35jk0YF2vN%2F01_log_in.jpg?alt=media&amp;token=ae0f905f-a55b-4b0a-aab1-ee77ff6baf1b" alt=""><figcaption></figcaption></figure> <figure><img src="https://3783386375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbAZwNh39hWp69xdDNc6%2Fuploads%2F6Pg8SmIDqnX8UX6Dawti%2F02_security_manage_api_tokens.jpg?alt=media&amp;token=99969c3b-2396-460d-a453-05f3682a8df4" alt=""><figcaption></figcaption></figure></div>
2. Select the ‘**Create API token’** button.\ <br>

   <figure><img src="https://3783386375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbAZwNh39hWp69xdDNc6%2Fuploads%2F7nfZdMFFwdMz9WTPzBch%2F03_create_api_token.jpg?alt=media&amp;token=f9256043-8a1d-490d-9a11-935c5bf88fbe" alt=""><figcaption></figcaption></figure>
3. In the **pop-up** dialog, provide a clear and memorable **Label** (we recommend using the **app's name**) for your token and click ‘**Create**’.<br>

   <figure><img src="https://3783386375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbAZwNh39hWp69xdDNc6%2Fuploads%2FMshOUrUhI7QX6iVV3qpW%2F04_label_create.jpg?alt=media&amp;token=ae639fd4-1a59-4f19-a222-1c53a9c86684" alt=""><figcaption></figcaption></figure>
4. Use the ‘**Copy**’ option to copy the token, and then **save** it into your script or another **secure location** for reference.\
   \
   **Important!** Make sure you see the confirmation '**API token copied to clipboard**' before closing the pop-up. Once the pop-up is closed, you won't be able to retrieve the token again. If you forget to copy it, you'll need to create a new one.<br>

   <div><figure><img src="https://3783386375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbAZwNh39hWp69xdDNc6%2Fuploads%2FvO3OB6r3voQN34SqvnFB%2F05_copy.jpg?alt=media&amp;token=677ce01c-6d95-4f45-8409-999da1243817" alt=""><figcaption></figcaption></figure> <figure><img src="https://3783386375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbAZwNh39hWp69xdDNc6%2Fuploads%2F2NwppxAil0IvC2Ootll8%2F06_paste_and_save.jpg?alt=media&amp;token=96e61982-0eba-4a70-a170-abc4b3286fed" alt=""><figcaption></figcaption></figure></div>
5. Now **navigate to the app** within your **Jira Cloud** instance.<br>

   <figure><img src="https://3783386375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbAZwNh39hWp69xdDNc6%2Fuploads%2FxPu6aogpKhsjkkHPxuR0%2F07_navigation_to_app_violet_no_arrows.jpg?alt=media&amp;token=5faeec26-4d60-4979-a1d3-3dfc89844947" alt=""><figcaption></figcaption></figure>
6. In the left-side menu go to ‘**Tokens**’ ➡️ ‘**Jira API Token**’.<br>

   <figure><img src="https://3783386375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbAZwNh39hWp69xdDNc6%2Fuploads%2FxJd8GcVr3HPRa1R9Z4Uf%2F08_navigation_left_bar.jpg?alt=media&amp;token=ef84fa06-9b77-4a4c-aedc-f9dfe870406a" alt=""><figcaption></figcaption></figure>
7. Input **Your Jira email** and then paste the **API Token** you copied earlier into the designated field. Once done, click '**Validate & Save**' to complete the process.\
   \
   This step is crucial for authenticating and saving your API Token in the system.<br>

   <figure><img src="https://3783386375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbAZwNh39hWp69xdDNc6%2Fuploads%2F5ErMvHHtsz2H7gXyKWsH%2F09_email_api_validate.jpg?alt=media&amp;token=67da8f41-291c-4c6a-8cc8-706eaf078b1a" alt=""><figcaption></figcaption></figure>
8. Once the **warning** sign turns **orange**, it indicates that your **API Token** has been **successfully saved** in the system. You can now use this token as your **credential** in the BI tool of your choice for secure data operations.<br>

   <figure><img src="https://3783386375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbAZwNh39hWp69xdDNc6%2Fuploads%2Fok332LdMYZAG2OnOuARy%2F10_warning_switch_orange.jpg?alt=media&amp;token=abac7c24-537a-4fb1-9172-d65597860b91" alt=""><figcaption></figcaption></figure>

***

A **single Jira API Token** can be used to log into **multiple BI tools**. There's no need to create separate tokens for each tool, simplifying the process and enhancing user convenience in managing various BI integrations.

***

To **delete** old **API tokens**, use the '**Revoke**' button on the same [page](https://id.atlassian.com/manage/api-tokens) where they were created. Once a token is revoked, it becomes invalid and can no longer be used for importing Jira data into your BI tool. This ensures that only current, valid tokens are in use for data security purposes.<br>

<div><figure><img src="https://3783386375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbAZwNh39hWp69xdDNc6%2Fuploads%2FGSU0xOoNotGbQScLEaMY%2F11_revoke.jpg?alt=media&amp;token=977d2972-bb00-4eb2-8f94-341c97562cf9" alt=""><figcaption></figcaption></figure> <figure><img src="https://3783386375-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FWbAZwNh39hWp69xdDNc6%2Fuploads%2FmAfyTkp7LeShnjsRPLGo%2F12_revoke_confirmation.jpg?alt=media&amp;token=14260c45-b3d0-4fe9-9c79-67cf3a4483b1" alt=""><figcaption></figcaption></figure></div>

***

If you've had the chance to use the **BI Exporter for Jira** app, we'd love to hear your **thoughts**. Help us improve by sharing your honest review of the [Free](https://marketplace.atlassian.com/apps/1233034/data-processor-for-jira-multi-bi-connector-free?hosting=cloud\&tab=reviews), [PRO](https://marketplace.atlassian.com/apps/1233504/data-processor-for-jira-link-power-bi-looker-tableau-pro?hosting=cloud\&tab=reviews), [Xray](https://marketplace.atlassian.com/apps/1233855/data-processor-for-xray-power-bi-tableau-looker-connector?hosting=cloud\&tab=reviews) or [Projectrak](https://marketplace.atlassian.com/apps/1235379/bi-exporter-for-projectrak-power-bi-looker-tableau-csv?hosting=cloud\&tab=reviews) versions. Your feedback is crucial as we strive to improve and tailor our services to better meet your needs. 🤝

***

Still have questions? Feel free to [**reach out to us**](/thecode4-docs/support.md) for any additional information or to request new features!