Jira · Integration Guide

With credentials

Create a scoped API token at id.atlassian.com/manage-profile/security/api-tokens and select the scopes below, then fill in the connection details.

1. Username: your Atlassian account email
2. Token: the API token you just created
3. BaseURL: https://{domain}.atlassian.net

Required Scopes

read:jira-work read:jira-user

Note:

The account that owns the token must also have Browse Projects permission on every project you want gathered — without it, project and issue queries return empty results even when the scopes are correct.

Link-only (on-prem)

Use this mode when Jira data is collected on-prem by your own pipeline and Milestone only needs to render deep links into Jira (e.g. {baseUrl}/browse/{ISSUE-KEY}).

1. Connection Name: a label so you can tell connections apart
2. Base URL: https://{domain}.atlassian.net (or your self-hosted Jira host)

No username or API token is required — Milestone will not call Jira's API in this mode.