> 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/integrate-jira-with-a-personal-access-token-hivel-agent.md).

# Integrate Jira with a Personal Access Token (Hivel agent)

#### 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="/files/FF3ww6tsl36IIuk0MYrv" 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="/files/7cBQqEQGwGxJeZIJfyBP" alt="" height="390" width="574">

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

   <img src="/files/CeEt3yGouEGIRyMYlxbM" 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="/files/OwCYEXGy5mIGvS1HyPXO" 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="/files/B2kCEqOEO8g7pUWpf2Vs" 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!