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.

Last updated

Was this helpful?