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

# WhatsApp Business OAuth 2.0 connector profile – StackOne setup guide

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

<Warning>Admin access to a Meta Business Portfolio and a verified WhatsApp Business Account (WABA) are required to complete this setup.</Warning>

<section data-guide-section data-guide-scopes="">
  <h2>Create a Meta App</h2>

  <p>Create a Meta App configured for WhatsApp. The current Meta UI uses a use-case-based flow that automatically creates a Business-type app with WhatsApp capability.</p>

  <Steps>
    <Step title="Go to Meta for Developers">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Go to <a href="https://developers.facebook.com/apps" target="_blank" rel="noopener noreferrer">Meta for Developers</a> and sign in.</p>

        <ul>
          <li>Click <strong>Create App</strong>.</li>
          <li>Enter an <strong>App name</strong> (e.g., "StackOne WhatsApp Integration") and an <strong>App contact email</strong>.</li>
          <li>Click <strong>Next</strong>.</li>
        </ul>
      </div>
    </Step>

    <Step title="Select Use Case (Scopes)">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>On the <strong>Add use cases</strong> screen:</p>

        <ul>
          <li>Select <strong>Connect with customers through WhatsApp</strong> and click <strong>Next</strong>.</li>
          <li>Also select <strong>Measure ad performance data with Marketing API</strong> — this enables Marketing API access and is required for the `business_management` permission used by business user and system user endpoints.</li>
          <li>You may also select any other use cases relevant to your app — additional use cases can be added now or later from your App Dashboard.</li>
          <li><strong>Note:</strong> The use cases you select here determine which permissions (scopes) are available during the OAuth flow. These map to the OAuth scopes you configure in this connector's <strong>Scopes</strong> field and should be provided there as a comma-separated list (e.g., `whatsapp_business_messaging,whatsapp_business_management,business_management`).</li>
        </ul>
      </div>
    </Step>

    <Step title="Select Business Portfolio">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Meta will prompt you to link a Business Portfolio:</p>

        <ul>
          <li>Select the <strong>Business Portfolio</strong> linked to your WhatsApp Business Account.</li>
          <li>Click <strong>Create app</strong>.</li>
          <li>If no portfolio appears, go to <a href="https://business.facebook.com/" target="_blank" rel="noopener noreferrer">Meta Business Suite</a>, create a Business Portfolio, and ensure you have Business Admin access.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Configure Facebook Login for Business</h2>

  <p>Configure the OAuth redirect URI for your app.</p>

  <Steps>
    <Step title="Open Facebook Login for Business">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In your App Dashboard left sidebar:</p>

        <ul>
          <li>Scroll down the left sidebar to find the <strong>Facebook Login for Business</strong> section.</li>
          <li>Click on it to expand and select <strong>Settings</strong>.</li>
        </ul>
      </div>
    </Step>

    <Step title="Configure Redirect URI">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>On the Settings page:</p>

        <ul>
          <li>Under <strong>Valid OAuth Redirect URIs</strong>, add `https://api.stackone.com/connect/oauth2/whatsapp-business/callback`.</li>
          <li>Click <strong>Save changes</strong>.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Get App ID and App Secret</h2>

  <p>Retrieve your app credentials to use during the OAuth connection setup.</p>

  <Steps>
    <Step title="Open Basic Settings">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In your App Dashboard, click <strong>App settings</strong> in the left sidebar and select <strong>Basic</strong>.</p>
      </div>
    </Step>

    <Step title="Copy Your Credentials">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>On the Basic Settings page:</p>

        <ul>
          <li>Copy the <strong>App ID</strong> — this is your Client ID.</li>
          <li>Click <strong>Show</strong> next to <strong>App Secret</strong>, verify your identity if prompted, then copy the value — this is your Client Secret.</li>
          <li>Store the App Secret securely and never expose it publicly.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

## Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for <strong>WhatsApp Business</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>WhatsApp Business</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>App ID</strong></li>
          <li><strong>App Secret</strong></li>
          <li><strong>Scopes</strong> (Optional)</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>WhatsApp Business</strong>.