Skip to main content

Azure DevOps integration

ClarityLoop integrates with Azure DevOps to bring pull requests and work items into feedback, 1:1s, and OKRs. Connect once, then attach Azure DevOps links to capture context automatically.

What the Azure DevOps integration includes​

  1. Pull request context capture

    • Attach Azure DevOps PR links to feedback, 1:1 agendas, OKRs, or competency framework.
    • ClarityLoop pulls key PR details (title, author, description) for richer context.

  2. Work item context capture

    • Attach work item links to connect execution to growth conversations.
    • ClarityLoop keeps the work item details alongside the feedback or goal.

  3. Webhook-powered updates

    • Azure DevOps service hooks keep PR and work item context up to date.
    • Comments can flow into ClarityLoop as context updates when authors match workspace members.

Installing the Azure DevOps integration​

📌 Only workspace owners can install the Azure DevOps integration.

  1. Go to Workspace Settings > Integrations
  2. Find Azure DevOps and click Connect
  3. Enter your Azure DevOps org URL (for example, https://dev.azure.com/your-org)
  4. Paste a Personal Access Token (PAT) with the following scopes:
    • Code (Read & Write)
    • Work Items (Read)
  5. Click Save access token to generate your webhook URL and secret.

Configure Azure DevOps service hooks​

After saving the token, ClarityLoop shows the webhook URL and Basic auth password (secret). In Azure DevOps:

  1. Open Project settings > Service hooks.
  2. Create a Web Hooks subscription for these events:
    • Pull request created
    • Pull request updated
    • Pull request comment created
    • Work item created
    • Work item updated
    • Work item comment created
  3. Paste the webhook URL and set Basic authentication password to the secret (username can be any value).
  4. Save the hook and repeat for other projects if needed.

How to use Azure DevOps with ClarityLoop​

  • Paste a PR or work item URL anywhere ClarityLoop accepts context links.
  • ClarityLoop fetches metadata and attaches it to feedback, 1:1s, and OKRs.
  • Keep growth conversations grounded in real delivery work.

FAQs​

Who can install the Azure DevOps integration?

Only workspace owners can install the integration.

What permissions are required for the PAT?

Use Code (Read & Write) and Work Items (Read) so ClarityLoop can fetch PR and work item data.

How do I rotate my token?

Reconnect Azure DevOps and save the new PAT to replace the old one.

How do I uninstall the integration?

Go to Workspace Settings > Integrations and remove Azure DevOps. You should also delete the service hooks in Azure DevOps.

Next steps: