Ctrlk
Go to Timebook
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Jira | Jira PD

About Jira integration

Currently, Timebook integrates with two Atlassian products:

  • Jira – allows simultaneous creation, editing, and updating solutions and projects between Timebook and the selected Jira epic/project

  • Jira Product Discovery – similar to Jira basic, but focuses on synchronizing opportunities and insights

lightbulb-gear

Technical-wise, the integration process is the same for both services and requires the same scopes and permissions. Follow below for detailed installation instructions.

Jira services in workspace settings

The integration allows for two types of synchronization:

  1. One-directional synchronization – updating an object in Timebook also does it in Jira, but not the other way around. Requires authentication with OAuth or an API token.

  2. Bidirectional synchronization – objects are fully synchronized between both services. Requires authentication with OAuth or an API token and configuring a webhook.

Requirements

To add the integration, you must:

  • create a dedicated service account in Jira with R/W access to the projects that you want to synchronize

  • use the account to configure the API token and webhook (for biderectional sync)

  • once configured, log out from the service account and use your regular Jira account for work

The account's name will be used as the username in Timebook in notifications for synchronization events.

Service account scopes

This is the list of scopes required for the service account to work.

One-directional synchronization

Method 1: OAuth

1

Go to Workplace settings → Integrations and select either Jira or Jira PD. Select OAuth as the access method.

2

Next, accept the request in Atlassian.

Make sure you're logged in to Jira as the dedicated service account.

OAuth access request screen in Atlassian
3

Once authenticated, paste the URL to your Jira workspace, e.g. https://company.atlassian.net

Method 2: Access token

1

Go to Workplace settings → Integrations and select either Jira or Jira PD. Select Access token as the access method.

2

Fill in the authentication details:

  • The URL to your Jira workspace, e.g. https://company.atlassian.net

  • The email address your Jira account, e.g. timebook_service@company.com

  • The API token generated in the Jira user security settings

Location of API token creation in Jira

Bidirectional synchronization

Once you authenticate in Jira, you can add a webhook that will allow you to synchronize work items in both ways.

1

Go to the system settings in your Jira workspace and create a webhook with the following scopes:

2

Generate the secret for the webhook in Jira and paste it back to Timebook.

3

Generate the webhook URL in Timebook and paste it back to Jira.

Webhook URL syntax: https://WORKPLACE.timebook.ai/api/pms/webhook/jira/HASH_NUMBER

Webhook configuration details in Jira

In the end, your configuration settings in Timebook should look like this:

Example of configured Jira integration settings (OAuth)

Syncing objects

Jira

Integrating with Jira allows you to recreate solutions and projects as epics in the selected Jira space together with their child work items.

Please mind you must have admin rights to configure synchronization between services.

Instructions:

1

Go to the solution or project that you want to sync.

2

Click the 'Send to delivery' button at the top navi-bar.

3

Select Jira as the target software and the team (space) to which you want to deliver your object.

4

Click 'Send' to sync the items.

Example: sending Timebook solution to Jira

Once synced, you will notice the Jira icon at the top of the screen together with the URL to the target object. All existing and newly created child items of the object will be automatically recreated in Jira.

Synced solution in Timebook

Solution recreated as epic in Jira

Jira Product Discovery

This integration will let you map Timebook opportunities and insights to Jira PD.

Please mind you must have admin rights to configure synchronization between services.

Instructions:

1

Go to the insight or opportunity that you want to sync.

2

Click the 'Sync...' button at the top navi-bar.

3

Select Jira PD as the target software and the team (space) with which you want to synchronize your opportunity or insight.

4

Click 'Push' to sync the items.

Example: sending Timebook opportunity to Jira PD

Once synced, you will notice the Jira PD icon at the top of the screen together with the URL to the target object. All insights belonging to the opportunity – existing or new – will be automatically recreated in Jira.

Synced opportunity in Timebook
Opportunity recreated as idea in Jira
PreviousAboutNextIntercom

Last updated