All articles

Wrike and Bitbucket Sync: Setup Guide

Overview

Note

The Wrike and Bitbucket two-way sync is powered by a partner: Unito.io. For even more information about how the two-way sync works, please check out Unito’s Help Center.

The Wrike and Bitbucket sync is part of the Wrike Sync add-on. It enables automatic updates between Wrike tasks and Bitbucket issues. Select a Bitbucket repository that you’d like to sync with Wrike and:

  • Wrike creates a task for each issue in the Bitbucket repository.

  • For any task created in, or added to, the synced folder or project in Wrike, Wrike creates a Bitbucket issue in the synced repository.

  • When you update a linked task, the linked issue is automatically updated (and vice versa).

Tip

This page explains how to set up the sync. To learn how the sync works and what you can do after it's in place, please see Wrike and Bitbucket Sync: Overview.

Set up the sync

Account admins and owners can set up the Wrike and Bitbucket two-way sync.

Before you begin

  • The Wrike and Bitbucket two-way sync works with Bitbucket.com. Because of API limitations, we're unable to support on-premise installations of Bitbucket.

  • To set up the sync with Wrike, it’s necessary to enable Issue Tracker in the Bitbucket repository that's being synced. You can read more about enabling Issue Tracker here.

  • When you set up the integration, a Wrike Bot is automatically created for you. The bot doesn't take up a Wrike user seat. A sync account isn't automatically set up in Bitbucket, so we strongly recommend creating one prior to setting up the first sync. You’ll find more details on how to do that below.

Step 1: Enable the Wrike Sync add-on in your Wrike account

Before setting up the two-way sync between Wrike and Bitbucket, you need to enable the Wrike Sync add-on in your Wrike account. You can find setup instructions on the Wrike Sync page.

Step 2: Create a Bitbucket test repository and sync account

Each sync setup begins with creating a folder or project in Wrike and a repository in Bitbucket that will be connected. To help you get a feel for how the sync works, create a test repository in Bitbucket and use it for your first sync.

Create a sync account in Bitbucket to better track when updates are made as a result of the sync. If you use a sync account and a user updates a task’s title in Wrike, then in Bitbucket you’ll see that the title of the synced issue was updated by the sync account. If you don’t use a sync account, then Bitbucket shows that a user (the user whose credentials you use to set up the sync) updated the issue.

To create a sync account, create a new Bitbucket user and name it Wrike Bot. Visit Unito’s Help Center to read more about what permissions the Wrike Bot account needs. Make sure you give the bot account access to the folder you want to sync.

Note

You only need to create a sync account in Bitbucket. In Wrike, there’s a special bot called Project Syncs Bot that's automatically added to your Wrike account when you set up the integration.

Step 3: Sync setup between Wrike and Bitbucket

To create your first sync:

  1. Click your profile image in the upper-right corner of the Wrike account.

  2. Select Apps and integrations.

  3. Click the Project syncs tab in the left panel.

  4. (Optional) If there are multiple Wrike accounts associated with your email, select the relevant one.

  5. Click the Create flow button.

  6. On the 1. Connect your tools card click Start here.

  7. You’ll see two cards on the screen for the two systems that you sync. The card at the top is reserved for Wrike by default.

  8. Click the + Choose account drop-down and select your Wrike account there.

  9. On the card at the bottom click + Add a tool to this flow drop-down and select Bitbucket.

  10. Then in the + Choose account drop-down that appears below, select + Connect a new Bitbucket account. You’ll be prompted to log in.

  11. Log in using the credentials of the bot account you created and authorize Unito.

  12. After connecting to your Bitbucket instance, you’ll be redirected to the sync.

  13. In the Project drop-down, select the existing Bitbucket repository you wish to sync.

  14. After setting up the Bitbucket card, select a connector for Wrike on the right card:

    • The Wrike via Project Syncs Bot option is selected automatically. If you keep this option selected, Bitbucket will show that the bot has updated the issue. In this case, if you’re processing the first sync, you need to create a Wrike project or folder that will be integrated with Bitbucket. That project or folder will be available for selection in future syncs.

    • If you choose Wrike via Username, then the updates in Bitbucket will show that the user whose credentials you select to set up the sync updated the issue.

  15. After both cards are set up, scroll down to choose the preferred sync direction.

  16. Click Next. You’ll be directed to a page where you can configure rules.

  17. Leave the filters as is to sync all issues and tasks by default.

  18. Click Next. You'll see the Field Mappings section where you can select what information should be synced between issues and tasks.

  19. Click Next. You’ll see the Options section. Here, you can disable Test Mode and Auto Sync.

  20. Click Create flow when all the preferred configurations are set up.

Your sync is created.

Note

If you have a lot of existing tasks or issues, then it may take a few minutes for the first sync to be completed. Tasks and issues are added continuously until all of them are synced.

To sync additional Bitbucket repositories with Wrike, repeat the steps starting from Step 3 above.

Edit existing syncs

  1. Click your profile image in the workspace’s upper right-hand corner.

  2. Select Apps and Integrations.

  3. Select the Project Syncs card.

  4. Click the three-dot menu button on the right side of the flow you wish to edit.

  5. Select Edit from the drop-down.

Now you can edit the sync.

Top