Save time switching between Azure DevOps and ClickUp. Use the Azure DevOps Sync integration to sync your Azure DevOps projects and work items with your ClickUp Workspace.
Sync integrations are in beta.
What you'll need
- The Azure DevOps Sync integration is available on the Business Plus and Enterprise Plans.
- Workspace owners and admins can set up the Azure DevOps Sync integration.
What is synced
Some work item data syncs two ways with ClickUp tasks, while other data only syncs one way. The tables below shows how each work item field syncs.
Two-way sync
The following work item data syncs both ways between Azure DevOps and ClickUp:
Work item field | ClickUp task field |
Name | Name |
State | Status |
Description Markdown formatting is not supported. If there is formatting on either side, it will be lost when it is synced. |
Description |
Comments Threaded comments don't sync. |
Comments |
One-way sync
The following work item data syncs from Azure DevOps to ClickUp, but not vice versa.
Work item field | ClickUp task field |
Assignee The emails used in ADO and ClickUp must match to sync. |
Assignee |
Tags | Tags |
Priority | Priority |
Start date | Start date |
Due date | Due date |
Number | Text Custom Field |
Relationship | Task link |
Start the sync
We recommend creating a new admin account in your Workspace to set up the sync. A service account with admin access is preferred.
To start the sync:
-
Using a ClickUp account with the same email as the Azure DevOps account with necessary permissions, open the App Center.
- Search for and select Azure DevOps Sync.
- Select Manage.
- Click Sign In with Azure DevOps.
- Choose an OAuth 2.0 grant type and input your organization, API version, username, and personal access token.
Read Microsoft’s guides on setting up personal access tokens and DevOps API versioning.
- Click Connect.
- After authentication finishes, click Start Sync to sync all of your Azure DevOps projects and work items. Once the status is Syncing, you can exit the modal or ClickUp.
Depending on the number of projects and work items you have, the sync could take several hours. You can continue working in ClickUp and check the progress of the sync any time from the App Center.
If a task fails the sync, open the task to see why. Errors are displayed as task comments from the admin who set up the integration.
Use the integration
After the sync is complete, you'll see a new Space called Azure DevOps that contains Folders for each Azure DevOps project. These Folders contain Lists representing each Azure DevOps work item type. Each List contains tasks for every work item.
You can add a task to a new location using Tasks In Multiple Lists and the sync will continue unless the original Azure DevOps List is deleted.
Pause the sync
You can pause the sync at any time.
From the App Center:
- Search for and select Azure DevOps Sync.
- Select Manage.
- Click Stop Sync. You can resume any time by clicking Start Sync.