The Azure DevOps integration in BoldDesk allows agents to create Azure DevOps work items from tickets, link existing work items, view work item details, and synchronize supported comments, status, and priority updates.

This article explains how to resolve validation, resource, ticket-linking, webhook, and processing errors displayed while using the Azure DevOps integration.

Prerequisites

Before troubleshooting, ensure that:

• The Azure DevOps app is installed and authorized in BoldDesk.
• Third-party application access via OAuth is enabled in the Azure DevOps organization.
• The required organization is selected and its projects are mapped in BoldDesk.
• The agent has permission to use the Azure DevOps app in BoldDesk.
• The agent can access the relevant Azure DevOps organization and project.

BoldDesk uses its own integration permissions. Permission to create work items directly in Azure DevOps does not automatically grant permission to create or link work items through BoldDesk.

Review the Azure DevOps Configuration

To review the integration configuration:

1. Go to Admin > Marketplace.
2. Search for and select Azure DevOps.
3. Open the installed app.
4. Review the selected Azure DevOps organization and mapped projects.
5. Review the configured synchronization actions and app permissions.
6. Save the configuration after making changes.

Only organizations and projects configured in the Azure DevOps integration are available when agents create or link work items.

Error Messages and Resolutions

General Processing Error

Error message
An error occurred when processing Azure DevOps integration.

This error appears when BoldDesk cannot complete the requested Azure DevOps operation.

Resolution

1. Refresh the ticket and retry the operation once.
2. Confirm that the Azure DevOps app is installed in BoldDesk.
3. Verify that the required organization and project are mapped under Admin > Marketplace > Azure DevOps.
4. Confirm that the affected project or work item is available in Azure DevOps.
5. If the error continues, review Integration failure logs under Admin > Audit Logs.
6. Contact BoldDesk Support if the failure details do not identify a configuration issue that can be corrected.

When contacting support, provide the BoldDesk ticket ID, Azure DevOps organization and project names, Work Item ID where applicable, exact error message, and time of the failure.

Azure DevOps Account Not Found

Error message
Azure DevOps account not found.

This error appears when BoldDesk cannot retrieve the Azure DevOps account associated with the installed integration.

Resolution

1. Go to Admin > Marketplace > Azure DevOps.
2. Confirm that the Azure DevOps app is installed.
3. Review the selected organization and mapped projects.
4. Confirm that the organization remains available in Azure DevOps.
5. Reconnect the Azure DevOps integration if the configuration page provides that option.
6. Save the configuration and retry the operation.
7. If the error continues, contact BoldDesk Support.

Required-Field Errors

The following errors appear when information required to create or link an Azure DevOps work item is missing.

Invalid Organization or Project

Applicable errors

• Invalid organization.
• Invalid project.

These errors indicate that BoldDesk cannot validate the selected Azure DevOps organization or project.

Resolution

1. Confirm that the organization or project exists in Azure DevOps.
2. Go to Admin > Marketplace > Azure DevOps.
3. Review the selected organization and mapped projects.
4. Select the required organization or project again.
5. Save the configuration.
6. Refresh the ticket and retry the operation.

If the organization or project is available in Azure DevOps and correctly configured in BoldDesk but the error continues, contact BoldDesk Support.

Linked Work Item Not Found

Error message
Linked work item not found.

This error appears when BoldDesk cannot retrieve the Azure DevOps work item associated with the ticket.

Resolution

1. Note the Work Item ID displayed in BoldDesk, if available.
2. Search for the Work Item ID in Azure DevOps.
3. Confirm that the work item exists in the selected project.
4. Refresh the BoldDesk ticket and reopen the Azure DevOps app.
5. If BoldDesk displays the linked item, unlink it before linking a replacement.
6. If the item cannot be retrieved or unlinked, contact BoldDesk Support.

Ticket-Eligibility Errors

The following errors appear when the current BoldDesk ticket state prevents an Azure DevOps work item from being linked.

Duplicate-Link and Link-Limit Errors

Work Item Already Linked

Error message
The work item you are trying to link is already linked to this ticket.

This error appears when the selected Azure DevOps work item is already associated with the current BoldDesk ticket.

Resolution

1. Close the linking dialog.
2. Refresh the Azure DevOps app panel.
3. Review the existing linked work item.
4. Continue using the existing association.

If the wrong work item is linked:

1. Select Unlink for the existing work item.
2. Confirm the unlink action.
3. Search for and link the correct work item.

Maximum Link Limit Reached

Error message
Linked work items exceed maximum limit.

This error appears when the BoldDesk ticket already has an Azure DevOps work item linked to it.

Resolution

1. Open the Azure DevOps app from the ticket.
2. Review the existing linked work item.
3. If the work item is correct, continue using the existing association.
4. To associate a different work item, select Unlink.
5. Confirm the unlink action.
6. Create or link the replacement work item.

A single BoldDesk ticket can be linked to only one Azure DevOps work item. The same Azure DevOps work item can be linked to multiple BoldDesk tickets.

Invalid Webhook Object

Error message
Invalid webhook object.

This error appears when BoldDesk cannot validate the webhook information used by the Azure DevOps integration.

Resolution

1. Retry the affected operation once.
2. Confirm that the Azure DevOps integration is installed and configured.
3. Confirm that the affected organization and project are mapped.
4. If the error continues, review Integration failure logs under Admin > Audit Logs.
5. Contact BoldDesk Support and provide:
   • BoldDesk ticket ID.
   • Azure DevOps Work Item ID, if applicable.
   • Organization and project names.
   • Exact error message.
   • Date, time, and time zone of the failure.

Work Item Type Is Not Available

Work Item Types are displayed after the agent selects an Organization and Project. The available values are retrieved for the selected Azure DevOps project.
If the required Work Item Type is not displayed:

1. Confirm that the correct Organization is selected.
2. Confirm that the correct Project is selected.
3. Clear and reselect the Project.
4. Review the Work Item Type list again.
5. Confirm in Azure DevOps that the required Work Item Type is available in the selected project.
6. If the Work Item Type is available in Azure DevOps but does not appear in BoldDesk, contact BoldDesk Support.

Area Path Is Not Available

The Area Path field is displayed after the Project and Work Item Type are selected.

If the required Area Path is not displayed:

1. Confirm that the correct Organization and Project are selected.
2. Confirm that a Work Item Type is selected.
3. Clear and reselect the Project and Work Item Type.
4. Review the Area Path list again.
5. Confirm in Azure DevOps that the required Area Path is available in the selected project.
6. If the Area Path is available in Azure DevOps but does not appear in BoldDesk, contact BoldDesk Support.

Contact BoldDesk Support

Contact BoldDesk Support if:

• A required-field error continues after the field is completed.
• A valid organization, project, Work Item Type, or Area Path is rejected.
• The Azure DevOps account cannot be retrieved after reviewing the integration configuration.
• A linked work item exists in Azure DevOps but BoldDesk reports that it cannot be found.
• A linked work item cannot be retrieved or unlinked.
• Invalid webhook object appears repeatedly.
• A general processing error affects multiple tickets.

Provide the following information:

• BoldDesk organization URL or organization ID.
• BoldDesk ticket ID.
• Exact error message.
• Screenshot showing the complete error and Azure DevOps app panel.
• Azure DevOps organization and project names.
• Work Item ID, if applicable.
• Action performed, such as creating, searching, linking, unlinking, or synchronizing a work item.
• Date, time, and time zone.
• Steps required to reproduce the error.
• Whether the issue affects one ticket or multiple tickets.
• Confirmation that the work item or project can be opened directly in Azure DevOps.

Frequently Asked Questions

1. What information is required to link an existing work item?
   Select the Organization and Project, enter the Azure DevOps Work Item ID, select the search icon, and select the returned work item.

2. Can multiple Azure DevOps work items be linked to one BoldDesk ticket?
   No. A BoldDesk ticket can be linked to only one Azure DevOps work item.

3. Can the same Azure DevOps work item be linked to multiple BoldDesk tickets?
   Yes. The same Azure DevOps work item can be linked to multiple BoldDesk tickets.

4. Does unlinking a work item delete it from Azure DevOps?
   No. Unlinking removes only the association in BoldDesk. The work item remains in Azure DevOps.

5. Can an Azure DevOps work item be deleted from BoldDesk?
   No. Work items cannot be deleted from BoldDesk. Deletion must be performed in Azure DevOps by a user whose project group has the required Delete and restore work items permission.

Related Articles

1. Installing and Configuring Azure DevOps in BoldDesk
2. How to Link Azure DevOps Work Items to BoldDesk Tickets
3. How to Create and Link an Azure DevOps Work Item from a BoldDesk Ticket
4. Creating Azure DevOps Work Items from Tickets in BoldDesk Mobile
5. How to Link an Azure DevOps Work Item to a BoldDesk Ticket in Mobile