> For the complete documentation index, see [llms.txt](https://docs.hivel.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hivel.ai/integrations/project-management/jira/jira-personal-access-token.md).

# Jira - Personal Access Token

#### Data Access by Hivel <a href="#data-access-by-hivel" id="data-access-by-hivel"></a>

Hivel accesses the past 30–90 days of data across the following event types:

**Issue-related events**

* JQL: All issues
* Issue: created, updated, deleted

**User-related events**

* User: created, updated, deleted

**Jira Software-related events**

* Sprint: deleted, updated, started, closed
* Initial sync of existing sprint data

#### Authorization Mechanism <a href="#authorization-mechanism" id="authorization-mechanism"></a>

* Hivel gets access using a Personal Access Token (API token), which you can create from your Atlassian account.
* Users maintain full control and can revoke access at any time by revoking the token.

#### Requirements <a href="#requirements" id="requirements"></a>

* Create the Personal Access Token from an account that has Project Administrator permissions for all relevant projects.

#### Creating the Token <a href="#creating-the-token" id="creating-the-token"></a>

**Step1: Navigate to**[ **https://id.atlassian.com/manage-profile/security/api-tokens**](https://id.atlassian.com/manage-profile/security/api-tokens)

There are two methods to choose from:

**Method 1: Create API Token (Preferred)**

1. Click **Create API token**.
2. Enter a name for the token (e.g., "Hivel") and set the longest expiry date your organization's policy allows.
3. Click **Create**, then copy the token immediately -you won't be able to view it again.

<img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2F7jXJB9mxcYuB8cydqZQi%2Funknown.png?alt=media&amp;token=ee480950-b0e7-411d-89e7-67c71bdc1ea7" alt="" height="393" width="667">

**Method 2: Create API Token with Scopes**

1. Click Create **API token with scopes**.
2. Enter a name for the token (e.g., 'Hivel') and set the longest expiry date your organization's policy allows.

<img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2Feqr4Lt0P5UEdKbWAC8nL%2Funknown.png?alt=media&amp;token=22d68623-93bb-4012-a53a-ef5064b1bda9" alt="" height="390" width="574">

1. Click **Next**.
2. Scroll down, **select Jira, and click Next**.

   <img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2Fpz40qQIKBz8MetF5kXqz%2Funknown.png?alt=media&amp;token=0ec4f971-ecf5-4a15-9050-376c6d2b5d4b" alt="" height="428" width="635">
3. Copy the whole block and paste it in the ‘search by scope’ field (see list below) and Set the Results per page to **100**. Select all the scopes.

   <img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FrPbWWD7xvvaPuN6Hd1fd%2Funknown.png?alt=media&amp;token=eb314782-0b9f-45de-a935-cd42c5432b8e" alt="" height="346" width="579">

**Scopes:**

```
read:field:jira
read:resolution:jira
read:status:jira
read:issue-type:jira
read:priority:jira
read:issue-link-type:jira
read:issue-details:jira
read:issue.changelog:jira
read:issue-worklog:jira
read:issue-link:jira
read:project:jira
read:project.component:jira
read:jql:jira
read:user:jira
read:jira-user
read:board-scope:jira-software
read:board-scope.admin:jira-software
read:sprint:jira-software
read:jira-work
```

1. Select all 19 scopes.
2. Ensure all the 19 scopes are selected and click **Create token**, then copy it immediately - you won't be able to view it again.

   <img src="https://3057781534-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5KAIOUWph0JLSgQqbzyT%2Fuploads%2FGIhZ9nDO2ItEInH0TdSO%2Funknown.png?alt=media&amp;token=75b0791f-e2bc-41dd-a8ab-88a10c4e4985" alt="" height="348" width="646">

#### Connect in Hivel <a href="#connect-in-hivel" id="connect-in-hivel"></a>

1. **Copy the generated token** immediately, as you won't be able to view it again.
2. Submit the token to Hivel.

Hivel validates the token instantly -if the token is wrong, expired, or revoked, Hivel shows a clear message telling you exactly what the problem is. Generate a new token with the correct permissions and reconnect.

That's it, all done!