Linear

About Linear integration

Adding the integration will let you simultaneously create, edit, and update items in Timebook and the selected Linear workspace.

The integration allows for two types of synchronization:

1. One-directional synchronization – only updates to Timebook items are reflected in Linear, not the other way around. Requires authentication over an API key.

2. Bidirectional synchronization – work items are fully synchronized between both Timebook and Linear. Requires authentication over an API key and configuring a webhook.

Requirements

To add the integration, you must:

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

• use the account to configure the API token and webhook

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

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

One-directional synchronization

Access token configuration

1

Go to Workplace settings → Integrations and switch to the Linear tab. Select Access token as the method and click the button to begin configuration.

2

In your Linear account, go to to Settings → Security & Access and create a new Personal API key with the following permissions:

Read: Read all workspace data available to you Write: Read and write all workspace data available to you

You can also restrict access to selected Linear teams.

API key configuration settings in Linear

3

Copy the API key and paste it back to Timebook.

Bidirectional synchronization

1

In the Linear settings, go to Administration → API and configure a webhook with these scopes:

Data change events: Issues, Projects

If restricting to specific teams, make sure that they match those selected in the API key.

2

Copy the signing secret and use it generate the webhook URL in Timebook. Paste it back to Linear to finish the webhook creation.

Webhook configuration settings in Linear

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

Example of configured Linear integration in Timebook

Syncing with Linear team

The last part is selecting the team in Linear that will be synchronized with Timebook. Depending on whether you have Teams activated, you can synchronize Linear in two ways:

1. Team: all work items in the selected Timebook team

2. Project: all work items in the selected Timebook project

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

Project-level synchronization

Synchronizing on this level will create a new project in Linear with all work items from the selected Timebook project.

This method also applies to Timebook solutions.

1

Go to the project with the work items you want to sync.

2

Expand project options with ... , top-right, and click 'Send to Linear'.

Project settings with Linear synchronization option.

3

Select the team in Linear and click the button to connect both services.

Team-level synchronization

Synchronizing on the team level will send updated work items assigned to your Timebook team to the selected Linear team.

1

Go to the settings of the Timebook team you want to sync.

2

Switch to Work Items → Linear integration and select your Linear team.

Selecting Linear team to synchronize in Timebook team settings