If your organization prefers or requires that Jira webhooks not be used, you can instead enable scheduled sync to ensure linked Jira issues stay up to date in Productboard.
In this article:
Why use scheduled sync?
Some organizations face challenges with the default webhook-based Jira integration due to:
- Internal security restrictions on external callbacks or exposed endpoints.
- Reliability concerns, such as missed or lost webhook events.
- Jira Cloud limits, which cap the number of webhooks per project.
Scheduled syncing solves these problems by using a secure and reliable polling mechanism instead.
How it works
When scheduled sync is enabled, Productboard polls Jira every 15 minutes and performs the following actions:
- Import new issues: If automatic import is enabled, new issues created in Jira will be pulled into Producboard when polled.
- Update mapped fields for existing issues: Only Jira fields mapped to Productboard fields will be updated. See Mapping fields between Jira and Productboard for details.
Scheduled syncs are idempotent and safe to retry.
You do not need to have webhooks configured at all to enable scheduled sync.
Enabling scheduled sync
To enable scheduled sync:
- From the bottom of the Main menu, click Settings > Integrations > Jira.
- Select the specific Jira integration you wish to configure.
- Scroll down to the Sync method section and select Scheduled sync (Polling).
- Click Save sync method preferences.
FAQ
What happens if both webhooks and polling are enabled?
- They won’t conflict. Productboard will use the selected sync method as your primary mechanism.
Can I switch between syncing methods?
- Yes, you can toggle between webhook and scheduled sync at any time from your Jira integration settings.
Will I miss updates if I use scheduled sync?
- No, but changes made in Jira will only be synced every 15 minutes. While not instant, it’s reliable and ensures compliance with security requirements.