# Jira

{% hint style="info" %}
Is your Jira hosted on-prem? Skip to the next page to connect [self-hosted-jira](https://docs.violetlabs.com/apps/j/jira/self-hosted-jira "mention").
{% endhint %}

### Connect Jira in Violet

1. In [Violet](https://app.violetlabs.com/) (or [VioletGov](https://app.violetgov.com/)), navigate to **Integrations** and click  <img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FtlFf29W81Xw97AUJ5zwb%2FScreenshot%202026-02-19%20at%201.13.34%E2%80%AFPM.png?alt=media&#x26;token=c80f613a-d379-4cd4-a5c8-9c04e63e37ea" alt="" data-size="line"> to add a new integration.&#x20;
2. Select <img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FTMgkaKQKTpQwdoEYjZve%2Fjira.png?alt=media&#x26;token=9eaafcdb-d0db-422a-abd3-1e6de0c56f7e" alt="" data-size="line"> **Jira**

\[Optional] You can also provide a unique name for the connection based on the credentials you're using, and you can create **restricted permissions** to users or groups:

<figure><img src="https://2091741164-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvrraExym8pNEUvBDoima%2Fuploads%2FLNq8XfPFudyBudwAhJwe%2Fpermissions.png?alt=media&#x26;token=502752e3-2f38-4c8b-8fa0-2ff8b3a5a19a" alt="" width="375"><figcaption></figcaption></figure>

3. Enter your Jira URL, username and API token (create an Atlassian API Token [here](https://id.atlassian.com/manage-profile/security/api-tokens)) and click **Connect.**\
   \
   **IMPORTANT: Jira recently introduced Scopes for its tokens, which we do not yet support. You will need to create a token without Scopes. You'll be able to create a token with Scopes OR connect directly via OAuth in January 2026. Stay tuned!**
4. Once connected, configure your integration (optional), then click **Create.** You're done!