> ## Documentation Index
> Fetch the complete documentation index at: https://docs.stackone.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Azure DevOps with Personal Access Token – StackOne Hub

> Link a Azure DevOps account in the StackOne Hub using Personal Access Token. End-user guide to authorize the integration and start using Azure DevOps actions.

<Warning>Personal Access Tokens grant access based on your Azure DevOps permissions. Copy the token immediately after creation — Azure DevOps does not store it and you will not be able to see it again.</Warning>

<section data-guide-section data-guide-scopes="">
  <h2>Generate a Personal Access Token</h2>

  <p>Create a PAT in Azure DevOps to authenticate the StackOne connection.</p>

  <Steps>
    <Step title="Open Personal access tokens">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in to <a href="https://dev.azure.com" target="_blank" rel="noopener noreferrer">Azure DevOps</a>, click the <strong>User settings</strong> icon in the top-right corner, and select <strong>Personal access tokens</strong>.</p>

        <img src="https://mintcdn.com/stackone-60/y3JLAGTnfHYE9tQB/connectors/azuredevops/images/custom-config-pat-menu.png?fit=max&auto=format&n=y3JLAGTnfHYE9tQB&q=85&s=f6175c2597746d02c34e0180458d8cec" alt="User settings menu open with Personal access tokens highlighted" width="1280" height="800" data-path="connectors/azuredevops/images/custom-config-pat-menu.png" />
      </div>
    </Step>

    <Step title="Open the new token panel">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>On the <strong>Personal Access Tokens</strong> page, click <strong>+ New Token</strong>.</p>

        <img src="https://mintcdn.com/stackone-60/y3JLAGTnfHYE9tQB/connectors/azuredevops/images/custom-config-new-token.png?fit=max&auto=format&n=y3JLAGTnfHYE9tQB&q=85&s=8994ad07fef4c15374a0108321494baf" alt="Personal Access Tokens page with the New Token button highlighted" width="1280" height="800" data-path="connectors/azuredevops/images/custom-config-new-token.png" />
      </div>
    </Step>

    <Step title="Configure and create the token">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In the <strong>Create a new personal access token</strong> panel, fill in the details and click <strong>Create</strong>.</p>

        <ul>
          <li><strong>Name</strong> — a label for the token (e.g., StackOne Integration).</li>
          <li><strong>Organization</strong> — select the organization you will connect.</li>
          <li><strong>Expiration (UTC)</strong> — set the expiry; the connection stops working when the token expires.</li>
          <li>Under <strong>Scopes</strong>, select <strong>Full access</strong> so every connector action (including webhook Service Hooks management) is covered. <strong>Custom defined</strong> with <strong>Show all scopes</strong> also works if you prefer granular scopes, but you must include all scopes the connector needs.</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/y3JLAGTnfHYE9tQB/connectors/azuredevops/images/custom-config-create-token.png?fit=max&auto=format&n=y3JLAGTnfHYE9tQB&q=85&s=eaf1e7751a20f22914895d941b234acf" alt="Create a new personal access token panel with Full access selected and highlighted" width="1280" height="800" data-path="connectors/azuredevops/images/custom-config-create-token.png" />
      </div>
    </Step>

    <Step title="Copy the token">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>On the <strong>Success!</strong> screen, copy the token and paste it into the <strong>Personal Access Token</strong> field in StackOne Hub.</p>

        <ul>
          <li>The token is only displayed once and cannot be retrieved later — per the on-screen warning: "Make sure you copy the above token now. We don't store it and you will not be able to see it again."</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/y3JLAGTnfHYE9tQB/connectors/azuredevops/images/custom-config-token-value.png?fit=max&auto=format&n=y3JLAGTnfHYE9tQB&q=85&s=5b5c4657672f47310812f08ebdd60b21" alt="Success dialog showing the one-time token value redacted with a copy button" width="1280" height="800" data-path="connectors/azuredevops/images/custom-config-token-value.png" />
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Find your organization details</h2>

  <p>Identify the Azure DevOps organization (and optionally a project) this connection should use.</p>

  <Steps>
    <Step title="Find your organization name">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Your organization name appears in the top-left of the Azure DevOps organization home page and in the browser URL. Enter it in the <strong>Organization</strong> field in StackOne Hub.</p>

        <ul>
          <li>Format: `https://dev.azure.com/{organization}`</li>
          <li>Example: if your URL is `https://dev.azure.com/s1-sandbox`, your organization is `s1-sandbox`</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/y3JLAGTnfHYE9tQB/connectors/azuredevops/images/custom-config-organization.png?fit=max&auto=format&n=y3JLAGTnfHYE9tQB&q=85&s=a64c71b89614430677febcb53a9c995b" alt="Azure DevOps organization home page with the organization name highlighted in the sidebar" width="1280" height="800" data-path="connectors/azuredevops/images/custom-config-organization.png" />
      </div>
    </Step>

    <Step title="Set the Project name for webhook scoping">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>The <strong>Project name (webhook scoping)</strong> field in StackOne Hub is optional in general, but required if you enable pipeline events — Azure DevOps only allows those to be created within a project, so their subscriptions fail if it is left blank. Work item, git, pull request, and build events work without it (delivered from all projects in the organization) or can be scoped to one project by setting it.</p>

        <ul>
          <li>Enter the project name exactly as it appears in your browser URL after the organization — the `{project}` segment of `https://dev.azure.com/{organization}/{project}`. For example, for `https://dev.azure.com/my-org/my-project` enter `my-project`.</li>
          <li>No need to look up any GUID — StackOne resolves the project name to the internal project ID automatically when it registers the webhooks.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<div data-whitelabel-hide>
  <h2>Linking the Account from the Hub</h2>

  <Steps>
    <Step title="Navigate to the Hub">
      Use one of the three <a href="/guides/accounts-section#linking-accounts">Linking Account Methods</a> to access the Hub.
    </Step>

    <Step title="Fill out the fields">
      Fill out the following fields using details from your provider:

      <ul>
        <li><strong>Personal Access Token</strong></li>
        <li><strong>Organization</strong></li>
        <li><strong>Project name (webhook scoping)</strong> (Optional)</li>
      </ul>
    </Step>

    <Step title="Connect">
      <ul>
        <li>Click <strong>Connect</strong></li>
        <li>If applicable, the provider will redirect you to a sign-in or authorization page. Complete the provider's authorization flow.</li>
        <li>Once authorization is successful, you will see a confirmation popup</li>
      </ul>
    </Step>
  </Steps>

  <p>If the account linking is successful, you will see the newly linked account in your <a href="/guides/accounts-section">Accounts</a> page.</p>
</div>

## Next Steps

<Columns cols={2}>
  <Card title="Webhooks setup" href="/connectors/azuredevops/guides/webhook-setup">
    <p className="connector-page-auth-description" style={{ fontSize: '14px', marginTop: 0, marginBottom: 0 }}>
      Configure receiving Events for Azure DevOps into StackOne.
    </p>
  </Card>
</Columns>
