Jira Integration

Enabling the Jira integration

To integrate Jira with WebWork:

• In your dashboard, go to the Integrations and click Enable below Jira
• Review the permissions WebWork needs and click Accept

• You will be redirected to WebWork after giving it access. Select the organization you’d like to enable the integration for and authorize.

Changing integration settings

After enabling the integration, you can change its settings in Integrations > Jira.

On the Members tab you can:

• Invite members
• Search for members
• Import members — when you import a member, their Jira role comes with them, so permissions stay consistent across both tools

To import members, select them and click Import:

On the Projects tab you can:

• View projects
• Import projects
• Select and import projects with certain statuses
• Import a project’s tasks, including sub-tasks, which stay linked to their parent issue so the hierarchy is preserved. Note that WebWork doesn’t currently distinguish between issue types on import — Tasks, Stories, Bugs, and Epics all come in as generic WebWork tasks, so the original Jira issue type isn’t preserved
• Each imported issue keeps the workflow status it had in Jira, so nothing loses context along the way
• Selected custom fields from Jira can be brought across as well, along with each issue’s original estimate

WebWork doesn’t import at the board level, and Scrum/Kanban board selection isn’t available — import is done per project. Sprints (state, capacity, or hours per ticket) also aren’t pulled into WebWork.

Syncing Data with Jira

To sync data from Jira to WebWork:

1. In your Jira dashboard, go to Manage Account > Security, and under API token, click Create and manage API tokens.
   
2. Create your API token and click Copy.
   
3. Go back to WebWork, paste your API token in the Sync Settings tab, and click Save.
   

To send tracked time data to Jira, enable the toggle at the bottom of the Auto-Sync tab and click Save.

Where to see sent tracked hours in Jira.

• Open the Jira board
• Select the desired issue
• Expand the issue details
• Locate the total tracked hours section

Note: in the members tab, you will only be able to see the users whose contact settings are set to Anyone on their Atlassian account. 

To set contact settings to anyone,

• Log into your Atlassian Account:
• Update Profile and Visibility Settings:
  • Go to Profile and Visibility settings.
  • Scroll down to the Contact section.
  • Change the visibility setting from Only you and admin to Anyone.

Keeping data in sync automatically

Once the integration is connected and your API token is in place, WebWork uses webhooks to keep everything up to date in real time. If you enable the toggle Two-way sync (push to Jira), the moment a status, assignee, summary, description, priority, or due date changes on an issue in Jira, that change is mirrored in WebWork right away — no manual syncing needed.

The sync also works the other way. Creating, updating, or deleting a task in WebWork is reflected back in Jira, and a status change made in WebWork drives the matching workflow transition in Jira.

Note that issues don’t transition automatically based on timer activity — starting or stopping a timer in WebWork doesn’t by itself trigger a Jira transition. Transitions only happen when you explicitly change an issue’s status in WebWork.