Connecting a Tracker
Connect Jira, Linear, Trello, GitHub, GitLab, or Azure DevOps to a Project.
Every Project connects to exactly one issue tracker. Most providers use an OAuth popup. Azure DevOps also supports a Personal Access Token when Microsoft sign-in isn’t a good fit — see below.
The general flow
Pick a tracker
On the Integration tab, click one of the six tracker cards.
Approve access
For OAuth providers, approve the requested scopes in the popup. Status moves from Connecting… to Waiting for authentication… to Connected as (your account).
For Azure DevOps you may instead paste a Personal Access Token — see the Azure tab below.
Choose the destination
Depending on the provider, pick the specific project, board, team, repository, or Azure Boards project (plus optional defaults).
Once connected, other tracker options are hidden for that Project — switching providers later means reconnecting with a different one.
Provider-specific notes
Connects via Atlassian OAuth. After authorizing, choose your Jira Cloud site and then the Jira project reports should be created in. See the Jira integration reference.
Connects via Linear OAuth. Choose a Linear team, and optionally a specific Linear project within it. See the Linear integration reference.
Connects via Trello OAuth. Choose the board cards should be created on. You can optionally map each Trello list to a SnagRelay status (Todo / In Progress / Done / Ignore) so board movement stays in sync. See the Trello integration reference.
Connects via GitHub OAuth (separate from any GitHub login you use for SnagRelay itself). Search and select the repository issues should be filed against. See the GitHub integration reference.
Connects via GitLab OAuth. Search and select the project issues should be filed against. Self-managed GitLab instances are supported via a configured host. See the GitLab integration reference.
Azure offers two connect paths:
- Microsoft sign-in — work/school Entra ID accounts
- Personal Access Token — org name + PAT (personal Microsoft accounts, or when OAuth isn’t available)
Then choose organization → project, and optionally work item type, default area, and default sprint. Work items go to Azure Boards. See the Azure DevOps integration reference.
Reconnecting
If a connection is revoked or a token expires, the Project shows an "Integration Disconnected" alert on Overview. Reports keep queuing and are delivered once you reconnect — see Integration Disconnected.
Default assignee, statuses, priorities, and labels
After connecting, SnagRelay syncs your tracker's team members, statuses, priorities, and labels so you can:
- Set a default assignee for new reports
- Control which assignees/statuses/priorities/labels are visible in the widget form (via the eye icon on Overview)
- Feed triage rules that auto-assign based on report content
Team seats vs tracker people
Names and avatars on Team Members are synced from your tracker. Inviting from that row gives them Chrome / editor access without creating a second SnagRelay dashboard account. The owner is the only dashboard user. See Team.