The pull request timeline feature captures pull/merge request (PR/MR) event history and projects reindex data to Signals. Install Git Integration for Jira to see detailed information in tasks and Backlog View.
Currently supported git services: GitHub and GitLab.
Understanding permission errors
If you do not configure the required extended permissions, reindex errors occur. The git host generates logs that detail the error cause.
Example GitHub error log:
{
"locations":[{"line":1,"column":1615}],
"type":"INSUFFICIENT_SCOPES",
"message":"Your token has not been granted the required scopes to execute this query. The 'email' field requires one of the following scopes: ['user:email', 'read:user'], but your token has only been granted the: ['admin:org_hook', 'admin:public_key', 'admin:repo_hook', 'read:org', 'repo'] scopes. Please modify your token's scopes at: https://github.com/settings/tokens."
}
Configuring project access token permissions
Git administrators must set these minimum permission requirements in the organization or group settings.
GitHub organization permissions
| Permission | Description |
|---|---|
| admin:org ➜ read:org | Enable read:org under the admin:org scope. This grants permission to read organization and team membership along with organization projects. Required to read user information for organization types. |
| user ➜ user:email | Enable user:email under the user scope. This grants read-only access to user email addresses. Required to match users with Jira. |
| user ➜ read:user | Optional. Grants read access to all user profile data. |
| read:discussion | Optional. Grants read access to team discussions. |
GitLab group permissions
| Permission | Description |
|---|---|
| Role | Minimum: Reporter role. |
| Scope | Minimum: read_api scope. |
Setting GitHub App integration scopes
When configuring a GitHub App integration, set these required scopes:
-
read:org – Grants permission to read organization and team membership, and organization projects
-
user:email – Grants read-only access to user email addresses
More on Signals
Last updated: December 2025
