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

# Intercom OAuth 2.0 connector profile – StackOne setup guide

> Set up the OAuth 2.0 connector profile for Intercom in StackOne. One-time admin setup required before your users can link Intercom accounts via Hub.

<section data-guide-section data-guide-scopes="">
  <h2>Create an Intercom OAuth App</h2>

  <p>Create an app in the Intercom Developer Hub to obtain your OAuth credentials.</p>

  <Steps>
    <Step title="Navigate to Developer Hub">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in to your <a href="https://app.intercom.com" target="_blank" rel="noopener noreferrer">Intercom account</a>.</p>

        <ul>
          <li>Click the <strong>Settings</strong> icon in the bottom left corner.</li>
          <li>Go to <strong>Integrations</strong> and click <strong>Developer Hub</strong>.</li>
        </ul>
      </div>
    </Step>

    <Step title="Create a new app">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In the Developer Hub, click <strong>New app</strong>.</p>

        <ul>
          <li>Enter an app name (e.g., `StackOne Integration`).</li>
          <li>Select the correct Workspace.</li>
          <li>Click <strong>Create app</strong>.</li>
        </ul>
      </div>
    </Step>

    <Step title="Configure OAuth settings">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In your app settings, navigate to the <strong>Authentication</strong> section.</p>

        <ul>
          <li>Click the <strong>Edit</strong> button in the top right corner.</li>
          <li>Under the <strong>OAuth</strong> section, check the <strong>Use OAuth</strong> checkbox to enable it.</li>
          <li>Click <strong>+ Add redirect URL</strong> and enter `https://api.stackone.com/connect/oauth2/intercom/callback`.</li>
          <li>Under the <strong>Permissions</strong> section, select the required permissions according to your needs.</li>
          <li>Ensure the <strong>Read admins</strong> permission is selected. This is required in order to connect the account successfully.</li>
          <li>Click <strong>Save</strong>.</li>
        </ul>
      </div>
    </Step>

    <Step title="Copy credentials">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Navigate to the <strong>Basic information</strong> section in the left sidebar to find your credentials.</p>

        <ul>
          <li>Copy the <strong>Client ID</strong>.</li>
          <li>Click the eye icon to reveal and copy the <strong>Client secret</strong>.</li>
          <li>Store both securely for use later.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

## Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for <strong>Intercom</strong>:

<Steps>
  <Step title="Navigate to Connector Profiles">
    Login to StackOne and navigate to [Connector Profiles](https://app.stackone.com/connector_profiles)
  </Step>

  <Step title="Create New Connector Profile">
    <ul>
      <li>Click <strong>+ Connector Profile</strong></li>
      <li>Search for and select <strong>Intercom</strong></li>
      <li>Select <strong>Type</strong> as <strong>OAuth 2.0</strong></li>

      <li>
        Fill out the fields using details retrieved from your provider:

        <ul style={{ marginLeft: '20px' }}>
          <li><strong>Client ID</strong></li>
          <li><strong>Client Secret</strong></li>
        </ul>
      </li>

      <li>(Optional) Select <strong>Actions</strong> to be enabled for this Connector Profile</li>
      <li>Click <strong>Create profile</strong></li>
    </ul>
  </Step>
</Steps>

Congratulations! The new Connector Profile will now show up in your project ready to be used. You can now continue to <a href="/guides/accounts-section#linking-accounts">Link Accounts</a> for <strong>Intercom</strong>.