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 Jira API Token

1. Go to Atlassian API Tokens

2. Click Create API token

3. Label it: Cycle Integration

4. Copy the token immediately – you won’t be able to see it again later.

---

Step 2: Set Up a Webhook in Jira

1. In your Jira instance, go to: Settings → System → Webhooks

2. Click Create a webhook

3. Fill in the following:

   • Name: Cycle Integration

   • Status: Enabled

   • URL: https://api.gear.cycle.app/jira_integration/cycle

   • Issue related events: Check "updated"

   • Projects: Leave blank to apply to all projects (or specify as needed)

---

Step 3: Create a Webhook in Cycle

1. Go to Settings → API

2. Click Create webhook

3. Fill out the fields:

   • Label: Jira or JPD

   • URL: https://api.gear.cycle.app/jira_integration/cycl

   • Trigger: Value changed

---

Step 4: Add a “Cycle URL” Custom Field in Jira

1. Go to Settings → Work items → Custom fields

2. Click Add custom field → Choose URL Field

3. Configure it as:

   • Name: Cycle URL

   • Description: Link to associated Cycle work item

4. Add this custom field to your Default Screen or any screen used for editing work items

---

Step 5: Share Your Setup Details with Cycle

To complete the integration on our side, please send us the following:

• Your Jira email address

• The API token you created in Step 1

• Your Jira workspace URL (e.g., https://yourcompany.atlassian.net)

Once we have this, we’ll take care of the rest.

---

🤝 Need Help?

Don’t hesitate to reach out – we’re here to help you get this up and running quickly.