Skip to main content

Azure DevOps integration

Azure DevOps is useful when both pull requests and work items matter in people conversations. ClarityLoop connects through an org URL, a PAT, and Azure service hooks so PRs and work items can bring real delivery context into feedback, goals, and 1:1s.

What Azure DevOps helps with​

Use Azure DevOps when you want ClarityLoop conversations to reflect:

  • pull request work
  • work item progress
  • engineering examples that are better shown than summarized

Who sets it up​

Workspace owners connect Azure DevOps for the workspace.

What you need before connecting​

  • your Azure DevOps org URL
  • a Personal Access Token with:
    • Code (Read & Write)
    • Work Items (Read)

After connecting in ClarityLoop, you also need to configure Azure DevOps service hooks.

How to connect Azure DevOps​

  1. Open Workspace Settings > Integrations.
  2. Find Azure DevOps.
  3. Enter the org URL and PAT.
  4. Save the connection.

ClarityLoop then gives you a webhook URL and a Basic auth password for the next step.

Configure Azure DevOps service hooks​

In Azure DevOps:

  1. Open Project settings > Service hooks.
  2. Create a Web Hooks subscription.
  3. Use the ClarityLoop webhook URL.
  4. Set the Basic authentication password to the value ClarityLoop provides.
  5. Subscribe to the PR and work item events you want ClarityLoop to receive.

You can reopen the integration later to view the instructions again.

How people use it​

Azure DevOps becomes useful inside ClarityLoop when PRs or work items help answer a real question:

  • What was delivered here?
  • What problem did this person handle well?
  • What work should we use as evidence in feedback or follow-up goals?

Use the integration to improve judgement, not to flood ClarityLoop with tickets.

How ClarityLoop uses Azure DevOps data​

  • Automatic context: supported Azure DevOps flows can bring pull request details, work-item details, and related collaboration into ClarityLoop so growth signals and feedback stay grounded in real work.
  • Manual linking: people can also attach a PR or work item directly when it is the clearest example for a 1:1, request, feedback note, or goal.

FAQs​

Who can install Azure DevOps?

Only workspace owners can connect it for the workspace.

Do we need both the PAT and service hooks?

Yes. The PAT supports access, and the service hooks keep Azure DevOps events flowing into ClarityLoop.

How do we rotate the PAT?

Reconnect Azure DevOps in ClarityLoop with the replacement token.

How do we disconnect it?

Remove the integration in ClarityLoop and delete the related service hooks in Azure DevOps if you no longer need them.

Next steps​