> 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/untitled.md).

# Untitled

### Data Access by Hivel

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

* 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

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

### Creating the Token

#### 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/vhzt07MNUGq1cgqGnqt5" 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/hwRl9lof0KkMBRvcr1cv" alt="" height="390" width="574">

3. Click **Next**.
4. Scroll down, **select Jira, and click Next**.

<img src="/files/whcqpAw7s56is3YrbLW9" alt="" height="428" width="635">

5. In the 'search by scope' field, paste in the required scopes (see list below) and Set the **Results per page** to 100.<br>

   <img src="/files/pLK5lMCbdZY9fpx8SLv7" 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-link:jira
* read:project:jira
* read:project.component:jira
* read:jql:jira
* read:issue-details:jira
* read:issue.changelog:jira
* read:issue-worklog:jira
* read:user:jira
* read:board-scope:jira-software
* read:sprint:jira-software
* read:board-scope.admin:jira-software
* read:jira-user
* read:jira-work

6. Select all 19 scopes.
7. 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/emSQOa60YUDw5IU2bF13" alt="" height="348" width="646">

### Connect in Hivel

1. **Copy the generated token** immediately, as you won't be able to view it again.
2. Paste the token into the **Personal Access Token field** and click **Connect**.

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!