> ## 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 MoEngage with Basic Auth (Workspace ID + API Key) – StackOne Hub

> Link a MoEngage account in the StackOne Hub using Basic Auth (Workspace ID + API Key). End-user guide to authorize the integration and start using MoEngage actions.

<section data-guide-section data-guide-scopes="">
  <h2>Find Your Workspace ID and Data Center</h2>

  <p>MoEngage uses HTTP Basic Auth where the username is your Workspace ID. The data center number tells the connector which regional API host to call.</p>

  <Steps>
    <Step title="Find your Data Center number">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Your data center is embedded in your dashboard URL.</p>

        <ul>
          <li>Open your MoEngage dashboard. The URL is `dashboard-0X.moengage.com` where `0X` is your data center number (01–06).</li>
          <li>Common regions: 01/04 = US, 02 = EU, 03 = India, 05 = Singapore, 06 = Indonesia.</li>
          <li>Note the number — you will enter it as the <strong>Data Center</strong> value when connecting.</li>
        </ul>
      </div>
    </Step>

    <Step title="Copy your Workspace ID">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Workspace ID is the username portion of Basic Auth.</p>

        <ul>
          <li>In the MoEngage dashboard, click your profile / settings icon, then go to <strong>Settings → Account → APIs</strong>.</li>
          <li>Locate the <strong>Workspace ID</strong> field (in legacy workspaces it may be labelled "App ID").</li>
          <li>Click the copy icon next to the Workspace ID. Save it for the Workspace ID field below.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Generate an API Key</h2>

  <p>Modern MoEngage workspaces use the API Key Dashboard to issue multi-permission keys. Generate a single key that has access to every API your integration needs.</p>

  <Steps>
    <Step title="Open the API Key Dashboard">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>The API Key Dashboard is under the same Settings → Account → APIs page.</p>

        <ul>
          <li>From the <strong>APIs</strong> page, switch to the <strong>API Key Dashboard</strong> tab.</li>
        </ul>
      </div>
    </Step>

    <Step title="Create a new key">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Issue a multi-permission key with access to all APIs the connector calls.</p>

        <ul>
          <li>Click <strong>Create API Key</strong>.</li>
          <li>Give it a name such as "StackOne Integration".</li>
          <li>Under <strong>Select APIs for access</strong>, check the boxes for <strong>Data</strong>, <strong>Segmentation</strong>, <strong>Push</strong>, <strong>Campaign Report</strong>, <strong>Business Events</strong>, <strong>Custom Templates</strong>, <strong>Content Blocks</strong>, <strong>Catalog</strong>, <strong>Subscription Preferences</strong>, <strong>Personalize</strong>, and <strong>Recommendations</strong> — every API you intend to use.</li>
          <li>Click <strong>Create</strong>.</li>
          <li>Copy the API key value from the confirmation dialog and store it securely. MoEngage shows the key in full only once.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Notes on legacy workspaces</h2>

  <p>Older MoEngage workspaces split API keys into per-tile keys (Data, Push, Campaign Report, Business Events, Custom Templates). If you are on a legacy workspace, you must enable the API Key Dashboard before you can issue a single multi-permission key. Contact MoEngage Support if the dashboard is not visible in your account.</p>

  <Steps>
    <Step title="Confirm dashboard availability">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>The connector requires a single API key. Per-tile keys are not currently supported.</p>

        <ul>
          <li>If you only see per-tile keys (Data tile, Push tile, etc.) and no API Key Dashboard, raise a support request with MoEngage to enable the dashboard for your workspace.</li>
        </ul>
      </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>Workspace ID</strong></li>
      <li><strong>Data API Key</strong></li>
      <li><strong>Campaign Report / Business Events / Templates / Catalog / Inform API Key</strong></li>
      <li><strong>Data Center</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.