- Confirm you have a Jira Cloud account and site URL.
- Create an API token in Atlassian.
- Paste credentials into SynthQA → Integrations → Jira.
- Run a test call to confirm connectivity.
Overview
The Jira integration is used to connect your SynthQA workspace to a Jira Cloud site so the app can validate access and prepare for issue creation / linking workflows.
Prerequisites
- Jira Cloud site URL (example: https://your-domain.atlassian.net)
- Your Jira account email
- An Atlassian API token
Create a Jira API token
Create an API token in your Atlassian account settings, then copy it somewhere safe. You will paste it into SynthQA once.
Note: Jira Server / Data Center uses different authentication than Jira Cloud. This page assumes Jira Cloud.
Connect in SynthQA
In the SynthQA app:
- Go to Integrations → Jira.
- Enter your Jira site URL, email, and API token.
- Save.
Test the connection
Use the “Test” action to validate that SynthQA can reach your Jira site and authenticate correctly.
Sync behavior
Current behavior is typically “connectivity + configuration” (depending on which features you’ve enabled). Issue creation and linking can be layered on once the connection is stable.
Troubleshooting
- Host URL parse error: Ensure your Jira URL starts with
https://. - 401/403: Confirm the email/token pair is correct and the token has not been revoked.
- 404: Validate the site URL (domain) is correct and reachable.
Security notes
Treat API tokens like passwords. Store them securely and rotate them if you suspect exposure.