Jira / Jira Product Discovery
to set up the Cycle integration with your Jira or Jira Product Discovery workspace, follow these steps:
Step 1: Get Your API Token
Click "Create API token"
Label it:
Cycle Integration
Copy the token immediately – you won’t be able to see it again later.
Step 2: Create a Webhook in Jira
In your Jira instance, go to: Settings → System → Webhooks
Click "Create a webhook"
Fill in the following:
Name:
Cycle Integration
Status: Enabled
URL:
https://gear-backend.onrender.com/jira_integration/
Issue related events: Check
"updated"
Projects: Leave blank for all projects (or specify certain ones if needed)

Step 3: Create a Cycle Webhook
Go to Settings → API
Click Create webhook
Label it as either
Jira
orJPD
Use this URL:
https://gear-backend.onrender.com/jira_integration/
Set the trigger to value changed
Don't touch the API token, it’s not needed in this setup

Step 4: Add a Custom Field for Cycle URL
Go to Settings → Work items → Custom fields
Click "Add custom field"
Choose "URL Field"
Configure the field:
Name:
Cycle URL
Description:
Link to associated Cycle work item
Add this custom field to the Default Screen (or whichever screen is used for editing work items)
Step 5: Share Your Details
Please provide:
Your email (used for Jira)
Your API token (from Step 1)
Your Jira workspace URL (e.g.,
https://yourcompany.atlassian.net
)
Once we have this, we can complete the setup for you. Let us know if you run into any issues — we're happy to help.
Last updated
Was this helpful?