Wrike and GitLab Sync: Setup Guide
Note
The Wrike and GitLab two-way sync is powered by our partner: Unito.io. For even more information about how the two-way sync works, please visit Unito’s Help Center.
The Wrike and GitLab sync is part of the Wrike Sync add-on, allowing for automatic updates between Wrike tasks and GitLab issues. Select a GitLab project that you’d like to sync with Wrike and:
-
Wrike creates a task for each issue in the GitLab project.
-
For any task created in or added to the synced folder or project in Wrike, Wrike creates a GitLab issue in the synced project.
-
When you update a linked Wrike task, then the linked GitLab issue is automatically updated (and vice versa).
Once the sync is in place, Wrike tasks become linked with corresponding GitLab issues and when you update a linked task, then the linked issue is automatically updated as well (and vice-versa). Your teams are able to collaborate effectively while remaining in the tool that they’re most familiar with.
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 GitLab Sync: Overview.
Account admins and owners can enable the Wrike and GitLab two-way sync.
Note
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 is not automatically set up in GitLab, and we strongly recommend creating one before setting up the first sync. You’ll find more details on this in Step 2 below.
Before setting up the two-way sync between Wrike and GitLab, you need to enable the Wrike Sync Add-On in your Wrike account. Instructions for enabling the add-on can be found on the Wrike Sync overview page.
Each sync setup begins with creating a folder or project in Wrike and a project in GitLab that will be connected. To familiarize yourself with the sync process, create test projects in both Wrike and GitLab and use these for your first sync.
A sync account helps track updates made as a result of the sync. If you use a sync account and a user updates a task’s title in Wrike, GitLab will show that the title of the synced issue was updated by the sync account. Without a sync account, GitLab will show that the user, whose credentials were used to set up the sync, updated the issue.
To create a sync account, create a new GitLab user and name it Wrike Bot. Visit Unito’s Help Center to read more about what permissions the Wrike Bot account requires. Make sure you give the bot account access to the GitLab projects you want to sync.
Note
You only need to create a sync account in GitLab. In Wrike, there’s a special bot called Project Syncs Bot that is automatically added to your Wrike account when you set up the integration.
To create the first sync:
-
Click your profile image in the sidebar.
-
Select Apps and integrations.
-
Click the Wrike Sync tab.
-
(Optional) If there are multiple Wrike accounts associated with your email, select the relevant one.
-
Click the Create flow button.
-
On the 1. Connect your tools card click Start here.
-
You’ll see two cards on the screen for the two systems that you sync. The card on the left is reserved for Wrike by default.
-
Click the + Choose account drop-down and select your Wrike account there.
-
On the card on the right, select a tool under Sync work in and select either GitLab or GitLab.com under Sync work in. Then, click the account drop-down and select Connect a new GitLab/GitLab.com account.
-
If you choose the GitLab option, enter your GitLab URL and follow the steps that will appear in the pop-up to set up your OAuth application.
-
If you choose the GitLab.com option, log in using the credentials of the bot account you created and authorize Unito.
-
-
After login, select the existing GitLab project you wish to sync.
-
After setting up the GitLab card, click on + Choose account for Wrike on the right card:
-
You can either choose the Wrike via Project Syncs Bot. If you keep this option selected, GitLab will show that the bot has updated the issue. In this case, if you are creating the first sync, you need to create a Wrike project or folder which will be integrated with GitLab. That project or folder will be available for selection in future syncs.
-
Or you choose the Username option, then the updates in GitLab will show that the user whose credentials you select to set up the sync updated the issue.
-
-
After both cards are set up, scroll down to choose the preferred sync direction.
-
Click Next. You’ll be directed to a page where you can configure rules.
-
Leave the filters as is to sync all issues and tasks by default.
-
Click Next. You'll see the Field Mappings section where you can select what information should be synced between issues and tasks.
-
Click Next. You’ll see the Options section. Here, you can disable Test Mode and Auto Sync and customize workflow and content.
-
Click the Create flow button when all the preferred configurations are set up.
Your sync is created.
Note
If you have a large number of existing tasks or issues, then it may take a few minutes for the first sync to complete. Tasks and issues are added continuously until they are all synced.
To sync additional GitLab projects with Wrike, repeat the steps starting from Step 3 above.
-
Click your profile image in the sidebar 1.
-
Select Apps and Integrations 2.
-
Click the Wrike Sync tab 3.
-
Click the three-dot menu button 4 on the right side of the flow you wish to edit.
-
Select Edit 5 from the drop-down.
Now you can edit the sync.