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

Integrating with Linear team

The last part is selecting which team you want to synchronize in each service.

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