> ## 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 Checkmk with Automation User – StackOne Hub

> Link a Checkmk account in the StackOne Hub using Automation User. End-user guide to authorize the integration and start using Checkmk actions.

<Warning>Admin-level permissions are required to create automation users.</Warning>

<section data-guide-section data-guide-scopes="">
  <h2>Get Your Checkmk Server URL</h2>

  <p>Identify your Checkmk server URL including the site name.</p>

  <Steps>
    <Step title="Find Your Server URL">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Your Checkmk server URL includes the hostname and site name. For example, if you access Checkmk at `https://monitoring.example.com/mysite`, then your server URL is `https://monitoring.example.com/mysite`.</p>
      </div>
    </Step>

    <Step title="Enter the Server URL">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Enter the full URL including protocol and site name (e.g., `https://monitoring.example.com/mysite`) in the <strong>Server URL</strong> field. Do not include `/check_mk/api/1.0` — it is added automatically.</p>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Create an Automation User</h2>

  <p>Create a dedicated automation user for API access.</p>

  <Steps>
    <Step title="Navigate to User Management">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Log in to the Checkmk GUI and go to <strong>Setup > Users > Users</strong>.</p>
      </div>
    </Step>

    <Step title="Create the Automation User">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click <strong>Add user</strong> and set the user type to <strong>Automation user</strong>. Give it a descriptive username (e.g., `api_automation`).</p>

        <ul>
          <li>An automation secret is generated automatically — you can also set one manually</li>
          <li>Automation users cannot log into the GUI — they are for API/script access only</li>
        </ul>
      </div>
    </Step>

    <Step title="Assign Permissions">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Go to <strong>Setup > Users > Roles and permissions</strong> and assign the appropriate role to the automation user. For full API access, assign the <strong>Administrator</strong> role.</p>
      </div>
    </Step>

    <Step title="Copy Credentials">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Copy the <strong>username</strong> and <strong>automation secret</strong> and paste them into the corresponding fields in StackOne. Keep the automation secret secure.</p>
      </div>
    </Step>
  </Steps>
</section>

## Linking the Account from the Hub

<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>Server URL</strong></li>
      <li><strong>Automation Username</strong></li>
      <li><strong>Automation Secret</strong></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>

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