Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Untitled

Integrate Jira with a Personal Access Token

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

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.

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.

  1. Click Next.

  2. Scroll down, select Jira, and click Next.

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

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

  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.

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!

Last updated