Documentation Index
Fetch the complete documentation index at: https://docs.mistle.dev/llms.txt
Use this file to discover all available pages before exploring further.
Overview
Jira can be connected in three ways:
- Personal API token
- Service account API token
- Service account OAuth client credentials
Use Personal API token when the connection should access Jira as a user account.
Use a service account token or OAuth client credentials when the connection should access Jira as a service account.
Option 1: Personal API Token
Personal API token gives access to Jira as that Atlassian user and is the only Jira option that currently supports managed webhook registration.
Create an Atlassian API token for that user at Atlassian API tokens, then connect in Mistle with:
| Field | Value |
|---|
| Site URL | Jira Cloud site URL like https://your-site.atlassian.net |
| Email | Atlassian account email |
| Personal API token | Atlassian API token |
Option 2: Service Account API Token
Service account API token gives access to Jira as a service account by using a scoped Atlassian API token.
Create a service account and a scoped API token, then connect in Mistle with:
| Field | Value |
|---|
| Cloud ID | Jira Cloud ID |
| Service account API token | Service account API token |
api.atlassian.com/ex/jira/<cloudId>/... API shape, so make sure you collect the cloud ID before connecting.
Option 3: Service Account OAuth Client Credentials
Service account OAuth client credentials gives access to Jira as a service account by exchanging a client ID and client secret for access tokens.
Create Atlassian OAuth 2.0 credentials for the service account, then connect in Mistle with:
| Field | Value |
|---|
| Cloud ID | Jira Cloud ID |
| Client ID | Atlassian OAuth client ID |
| Client secret | Atlassian OAuth client secret |
Webhooks
Managed webhook registration is currently supported only for personal API token connections.
After the connection exists, use the Webhooks section on that connection. The product already shows the callback URL to copy into Jira, and the managed webhook registration can be created from there.
Jira Cloud
The current Jira integration is Jira Cloud only.
The connection schemas require Atlassian Cloud values such as *.atlassian.net site URLs and Cloud ID.
Official References
