Workplace integrations

Enhance your Timebook experience by connecting external apps.

Expand your work with Timebook

In this section of Workplace Admin, you can boost your by integrating it with other apps. We want to give you one platform to manage all your work, and that includes external resources integrated with Timebook.

The following sections describe the available Timebook integrations.

Integrations presented here will impact the entire Workplace as all members can use them.

But Timebook also allows integrations for individual users. For more information, see Integrations

---

Git integration

Git is one of the most popular version control systems. It's an actively maintained open-source tool that works well on various operating systems. And you can integrate it with Timebook!

The integration between Timebook and Git is made possible by the connecting element we call the "friendly ID" - a unique number attached to each Timebook . By including the friendly ID in commit messages, you can directly link your code changes to specific Work Items in Timebook.

You can integrate with Git using different services.

When you open the [Git] tab in the [Integrations] section, you must first select the provider you want to integrate with.

Integrate Timebook with Bitbucket

1. Go to the [Integrations] section in the Workplace Admin and open the [Git] tab.

2. Select the [Bitbucket] option and press [Integrate].

3. Use the toggle at the top to [Enable Bitbucket branch creation].

4. You must now provide the following:

   • Your [User name] in Bitbucket.

   • The [App password] you generated in Bitbucket. For more information on app password creation, see this Bitbucket help page.

   • Your Bitbucket [Namespace]. For more information on namespaces, see this GitLab help page.

5. Once we verify these credentials, you can start adding Bitbucket repositories. To do so, select a repository from the dropdown list and provide your access token. For more information on repository access tokens, see this Bitbucket help page.

Integrate Timebook with GitHub

1. Go to the [Integrations] section in the Workplace Admin and open the [Git] tab.

2. Select the [GitHub] option and press [Integrate].

3. Use the toggle at the top to [Enable GitHub branch creation].

4. You must now provide your GitHub organization and access token. For more information on access tokens, see this GitHub help page. Remember to select appropriate scopes for your token. Scopes define the accessibility of GitHub repositories in Timebook.

5. Once we verify your access token, you will see additional options:

   • the [Enable GitHub integration] toggle to turn the integration on and off,

   • the [Trash] icon to remove this integration from your Timebook Workplace,

   • the [GitHub repository list] to connect additional repositories.

Integrate Timebook with GitLab

1. Go to the [Integrations] section in the Workplace Admin and open the [Git] tab.

2. Select the [GitLab] option and press [Integrate].

3. Use the toggle at the top to [Enable GitLab branch creation].

4. You must now provide the following:

   • Your [GitLab group]. For more information on groups, see this GitLab help page.

   • The GitLab [Access token]. For more information on tokens, see this GitLab help page.

   • Optionally, you can provide the URL address of your server.

5. Once we verify these credentials, you can start adding GitLab repositories.

Once you integrate Timebook with Git using one of the methods above, you will notice that:

• We will automatically turn on Bitbucket or GitHub webhooks for Git commits and pull requests. You can turn them off with the dedicated toggle.

• Timebook Work Item card will show the dedicated [Git] field where you can find all the Git information relevant to a given Work Item.

The [Git] field on a Work Item card will only be visible if you enable the Git system field for the item type to which your Work Item belongs.

You can manage fields for selected Work Item types using our Item library

---

Related articles

Integrations

Work Item

Item library