> ## 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 New Relic with API Key – StackOne Hub

> Link a New Relic account in the StackOne Hub using API Key. End-user guide to authorize the integration and start using New Relic actions.

<section data-guide-section data-guide-scopes="">
  <h2>Generate a User API key</h2>

  <p>New Relic authenticates this integration with a personal User API key. Create one from the<br /><strong>API Keys</strong> page of your New Relic account.</p>

  <Steps>
    <Step title="Open the API keys page">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in to New Relic and open the <strong>API keys</strong> page (<strong>Administration → API Keys</strong>) for the<br />region your account is hosted in:</p>

        <ul>
          <li><strong>US</strong> — <a href="https://one.newrelic.com/api-keys" target="_blank" rel="noopener noreferrer">New Relic US API keys page</a></li>
          <li><strong>EU</strong> — <a href="https://one.eu.newrelic.com/api-keys" target="_blank" rel="noopener noreferrer">New Relic EU API keys page</a></li>
          <li>The page is the same in both regions — only the host differs.</li>
        </ul>
      </div>
    </Step>

    <Step title="Create a new key">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>On the <strong>API keys</strong> page, click <strong>Create a key</strong>.</p>

        <img src="https://mintcdn.com/stackone-60/taSDfrd-ek8zJVcR/connectors/newrelic/images/custom-config-create-a-key.png?fit=max&auto=format&n=taSDfrd-ek8zJVcR&q=85&s=032e37565cc1382c3540cbe421b20ffe" alt="New Relic API keys page with the Create a key button highlighted" width="1280" height="800" data-path="connectors/newrelic/images/custom-config-create-a-key.png" />
      </div>
    </Step>

    <Step title="Set the key type to User">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In the <strong>Create an API key</strong> panel, pick the account the key should belong to in the<br /><strong>Account</strong> dropdown, and make sure <strong>Key type</strong> is set to <strong>User</strong> (the default selection).<br />As the panel explains, <strong>User keys</strong> are for querying data and managing configurations<br />(Alerts, Synthetics, dashboards, etc.).</p>

        <img src="https://mintcdn.com/stackone-60/taSDfrd-ek8zJVcR/connectors/newrelic/images/custom-config-key-type-user.png?fit=max&auto=format&n=taSDfrd-ek8zJVcR&q=85&s=492814218ead662454b59a7faffd6fb0" alt="Create an API key panel with the Key type dropdown set to User" width="1280" height="800" data-path="connectors/newrelic/images/custom-config-key-type-user.png" />
      </div>
    </Step>

    <Step title="Enter a name and create the key">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Enter a descriptive <strong>Name</strong> (for example `StackOne Integration`), optionally add <strong>Notes</strong>,<br />and click <strong>Create a key</strong>.</p>

        <img src="https://mintcdn.com/stackone-60/taSDfrd-ek8zJVcR/connectors/newrelic/images/custom-config-name-and-create.png?fit=max&auto=format&n=taSDfrd-ek8zJVcR&q=85&s=e05d70d23b9de85de1583fe8e9a54a26" alt="Create an API key panel with a name filled in and the Create a key button highlighted" width="1280" height="800" data-path="connectors/newrelic/images/custom-config-name-and-create.png" />
      </div>
    </Step>

    <Step title="Copy the User API key">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>A banner appears above the key list reading <strong>Copy your API Key now. You won't be able to see it again!</strong><br />Click <strong>Copy Key</strong> and paste the value into the <strong>User API Key</strong> field in StackOne Hub.</p>

        <ul>
          <li>The key is only displayed once and cannot be retrieved later. If you lose it, create a new key.</li>
          <li>Format: `NRAK-` followed by an alphanumeric string</li>
          <li>Example: `NRAK-XXXXXXXXXXXXXXXXXXXXXXXXXXX`</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/taSDfrd-ek8zJVcR/connectors/newrelic/images/custom-config-copy-key.png?fit=max&auto=format&n=taSDfrd-ek8zJVcR&q=85&s=a7e9a65ab6211f381234ee66e07d77fe" alt="Banner prompting to copy the API key now with the Copy Key button highlighted" width="1280" height="800" data-path="connectors/newrelic/images/custom-config-copy-key.png" />
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Find your Account ID and region</h2>

  <p>StackOne Hub also needs the New Relic account the key belongs to and the data-center region it<br />is hosted in.</p>

  <Steps>
    <Step title="Locate your Account ID">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Still on the <strong>API keys</strong> page, read the number in the <strong>Account ID</strong> column of your key's<br />row, and paste it into the <strong>Account ID</strong> field in StackOne Hub.</p>

        <ul>
          <li>It also appears as the `account` parameter in the page URL when you are logged in, e.g. `one.newrelic.com/admin-portal/api-keys/home?account=1234567`.</li>
          <li>Format: a numeric ID</li>
          <li>Example: `1234567`</li>
        </ul>

        <img src="https://mintcdn.com/stackone-60/taSDfrd-ek8zJVcR/connectors/newrelic/images/custom-config-account-id.png?fit=max&auto=format&n=taSDfrd-ek8zJVcR&q=85&s=62aa72246a17f0042f44fb7d327773b4" alt="API keys table with the Account ID column highlighted" width="1280" height="800" data-path="connectors/newrelic/images/custom-config-account-id.png" />
      </div>
    </Step>

    <Step title="Choose your API Region">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In StackOne Hub, set the <strong>API Region</strong> field to the data center your account is hosted in.</p>

        <ul>
          <li>Pick <strong>US (api.newrelic.com)</strong> if you sign in at `one.newrelic.com`.</li>
          <li>Pick <strong>EU (api.eu.newrelic.com)</strong> if you sign in at `one.eu.newrelic.com`.</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>User API Key</strong></li>
        <li><strong>Account ID</strong></li>
        <li><strong>API Region</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>

  <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>