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:
One-directional synchronization – only updates to Timebook items are reflected in Linear, not the other way around. Requires authentication over an API key.
Bidirectional synchronization – work items are fully synchronized between both Timebook and Linear. Requires authentication over an API key and configuring a webhook.
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.
Go to Workplace settings → Integrations and click Lineaar. Select OAuth as the access method.
Next, select the teams that you want to sync and accept the request in Linear.
Make sure you're logged in to Linear as the dedicated service account.
Go to Workplace settings → Integrations and switch to the Linear tab. Select Access token as the method and click the button to begin configuration.
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.
Copy the API key and paste it back to Timebook.
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.
Copy the signing secret and use it generate the webhook URL in Timebook. Paste it back to Linear to finish the webhook creation.
In the end, your Linear settings in Timebook should look like this:
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:
Team: all work items in the selected Timebook team
Project: all work items in the selected Timebook project
Please mind you must have admin rights to configure synchronization between services.
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.
Go to the project with the work items you want to sync.
Expand project options with ... , top-right, and click 'Send to Linear'.
Select the team in Linear and click the button to connect both services.
Synchronizing on the team level will send updated work items assigned to your Timebook team to the selected Linear team.
Go to the settings of the Timebook team you want to sync.
Switch to Work Items → Linear integration and select your Linear team.
Last updated
