This guide helps you ensure your Marker.io integration with Jira works with full 2-way synchronization, including issue status updates and comment sync.

The simplest way: Connect via OAuth (recommended)

If you connect your Jira account via Cloud (OAuth), full functionality works out of the box. No admin permissions required.

OAuth allows Marker.io to automatically create and manage webhooks in Jira on your behalf. This means:

✅ Issue status sync works automatically
✅ Comment sync works automatically
✅ No need for Product Admin access
✅ No manual webhook setup required

How to connect via OAuth

Go to your Marker.io dashboard and create or edit a project.
When prompted to connect your Jira account, select Cloud (OAuth).
Authorize Marker.io in the Atlassian popup and you're done!

Already connected via API token? You can switch to OAuth at any time. Go to Workspace → Shared accounts, connect a new Jira account via OAuth, then update your project to use the new account under Website → Settings → Integration → Main account.

If you're using an API token connection

If you connected Jira via API token (instead of OAuth), full sync requires the connected Jira account to have the Product Admin role. Without it:

❌ Issue status sync only works on manual refresh
❌ Comment sync does not work

You have two options to fix this:

Option 1: Switch to OAuth (recommended)

The easiest solution is to switch your connection method to OAuth. See the steps above. No admin permissions needed, and everything syncs automatically.

Option 2: Use a service account with Product Admin access

If you prefer to stay on an API token connection, ensure the connected Jira account has the Product Admin role:

Create a service account in Jira (or use an existing admin account).
Assign the Product Admin role to this account.
Use this account to connect Marker.io to Jira.

For detailed steps, refer to our service account guide.

Option 3: Set up a manual webhook (advanced)

If you can't use OAuth and can't get Product Admin access, you can set up a manual webhook as a workaround. This requires your Jira Administrator to create a webhook in Jira.

Step 1: Enable manual webhook in Marker.io

Go to your Marker.io Project Settings → Integration Settings.
Select Manual Webhook.
Copy the Webhook URL and Jira Webhook Secret. You'll need to share these with your Jira Administrator.

Step 2: Identify your Jira project details

Note the Jira project you want to connect:

Project Name (e.g., Jira_Marker_101)
Project Key (e.g., JM1)

Step 3: Jira Administrator creates the webhook

Your Jira Administrator needs to:

Go to System → Webhooks → Create Webhook in Jira.
Configure the webhook:
- Name: e.g., Marker.io Webhook
- Status: Enabled
- URL: Paste the Webhook URL from Step 1
- Secret: Paste the Jira Webhook Secret from Step 1
For Issue related events, type project = and select your Jira project.
Select the following events:
- Issue events: Created, Updated, Deleted
- Comment events: Created, Updated, Deleted
Click Create.

Once the webhook is set up, issue status and comment sync will work. You may still see configuration warnings in Marker.io. These can be safely ignored.