This guide walks you through the steps to ensure your Marker.io integration with Jira works properly, including issue status and comment sync. If you have issues, this document provides solutions and workarounds.
Why the Product Admin Role Matters
If the Jira account you connect to Marker.io does not have the Product Admin role:
Issue status sync only works when you refresh tickets manually.
Comment sync does not work.
Option 1: Best Practice - Use a Service Account with Product Admin Access
To avoid these limitations, we recommend creating a service account in Jira with Product Admin access. Here’s how to set it up:
Create a service account in Jira.
Assign the Product Admin role to this account.
Use this account to connect Marker.io to Jira.
For detailed steps, refer to this guide.
Option 2: Workaround - Use Webhooks for Limited Permissions
If you can’t use a Product Admin account, you can set up a webhook instead. This allows issue and comment synchronization without requiring full permissions.
Step-by-Step Guide to Set Up a Webhook:
1. Enable Manual Webhook in Marker.io
Go to your Marker.io Project Settings > Integration Settings.
Select Manual Webhook.
Copy these two values:
Webhook URL
Jira Webhook Secret
You’ll need to share these with your Jira Administrator.
2. Identify the Jira Project Details
Make sure you know the Jira project you want to connect to and note its details:
Example:
Project Name (e.g.,
Jira_Marker_101)Project Key (e.g.,
JM1)
3. Jira Administrator: Create the Webhook
Your Jira Administrator needs to follow these steps:
Navigate to the Webhook Setup
Go to System > Webhooks > Create Webhook in Jira.
Configure the Webhook
Name: e.g.,
Marker.io Webhook 01Status: Enabled
URL: Paste the Webhook URL from Step 1.
Secret: Paste the Jira Webhook Secret from Step 1.
Description: Add a note, e.g., “Created webhook to integrate Marker.io for website launch.”
Set Issue and Comment Events
For Issue related events Type
project =and select the relevant jira project as caputured in step 2 above.Finally, configure events as follows:
Issue Events: Select the following:
Created
Updated
Deleted
Comment Events: Select the following:
Created
Updated
Deleted
Save: Scroll to the bottom and click Create.
3. Test the Integration
Once the webhook is set up:
Issue status synchronization will work.
Comment synchronization will work.
You may still see configuration warnings in Marker.io. These can be ignored for now, as a future update will address them.
Need Help?
If you have any questions, contact us at support@marker.io.