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

# Mailchimp OAuth 2.0 connector profile – StackOne setup guide

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

<Warning>Admin or Account Owner permissions in Mailchimp are required to create OAuth applications.</Warning>

<section data-guide-section data-guide-scopes="">
  <h2>Creating an OAuth Application</h2>

  <p>Create an OAuth application to obtain Client ID and Client Secret for secure integration.</p>

  <Steps>
    <Step title="Sign in to Mailchimp">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Sign in to your <a href="https://login.mailchimp.com/" target="_blank" rel="noopener noreferrer">Mailchimp account</a> with Admin or Owner permissions.</p>
      </div>
    </Step>

    <Step title="Navigate to Registered Apps">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>From your Mailchimp account page:</p>

        <ul>
          <li>Navigate to your account settings (Account & billing).</li>
          <li>Click on <strong>Extras</strong> in the top navigation menu.</li>
          <li>Select <strong>Registered Apps</strong> from the dropdown menu.</li>
        </ul>
      </div>
    </Step>

    <Step title="Register a New App">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>On the Registered Apps page:</p>

        <ul>
          <li>Click the <strong>Register An App</strong> button.</li>
          <li>Fill in the required fields - <strong>App name</strong> (e.g., "StackOne Integration"), <strong>App description</strong>, <strong>Company/organization</strong>, and <strong>App website</strong>.</li>
          <li>Optionally upload a logo (JPG, GIF, or PNG, up to 1MB).</li>
          <li>Enter the <strong>Redirect URI</strong> `https://api.stackone.com/connect/oauth2/mailchimp/callback`.</li>
          <li>Click <strong>Create</strong> to generate your application.</li>
        </ul>
      </div>
    </Step>

    <Step title="Copy Client ID and Secret">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>After creating the app:</p>

        <ul>
          <li>Copy the <strong>Client ID</strong> from the app details page.</li>
          <li>Copy the <strong>Client Secret</strong> and store it securely.</li>
          <li>The Client Secret is displayed once - save it immediately.</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

<section data-guide-section data-guide-scopes="">
  <h2>Finding Your Server Prefix</h2>

  <p>Your server prefix identifies the Mailchimp datacenter for your account and is required for API requests.</p>

  <Steps>
    <Step title="Obtain from OAuth Metadata">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>After OAuth authorization completes:</p>

        <ul>
          <li>The server prefix is retrieved automatically from the OAuth metadata endpoint at `https://login.mailchimp.com/oauth2/metadata`.</li>
          <li>The metadata response includes the datacenter prefix (e.g., us1, us19).</li>
        </ul>
      </div>
    </Step>

    <Step title="Alternative Method">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>You can also find your server prefix:</p>

        <ul>
          <li>Look at your Mailchimp account URL when logged in (e.g., `https://us19.admin.mailchimp.com`).</li>
          <li>The prefix is the subdomain before `.admin.mailchimp.com` (e.g., "us19").</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

## Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for <strong>Mailchimp</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>Mailchimp</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>
          <li><strong>Server Prefix</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>Mailchimp</strong>.
