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

# TikTok Ads OAuth 2.0 connector profile – StackOne setup guide

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

<Warning>A company email address and TikTok for Business account are required. App approval typically takes 2-7 business days.</Warning>

<section data-guide-section data-guide-scopes="">
  <h2>Create a TikTok for Business Developer App</h2>

  <p>You need a developer account on the TikTok for Business Developer Portal and an approved app to obtain OAuth credentials.</p>

  <Steps>
    <Step title="Register or Log In">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Go to the <a href="https://business-api.tiktok.com/portal" target="_blank" rel="noopener noreferrer">TikTok for Business Developer Portal</a>. If you don't have an account, click <strong>Register for TikTok for Business</strong> to create one. If you already have an account, click <strong>Log in</strong>.</p>

        <ul>
          <li>A company email address is required for registration (personal emails like Gmail or Hotmail will not be accepted)</li>
          <li>You will need to provide your company name, website, and business type during registration</li>
        </ul>
      </div>
    </Step>

    <Step title="Go to My Apps">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>After logging in, click <strong>My Apps</strong> in the top-right navigation bar (or click the <strong>Go to my apps</strong> button on the homepage).</p>
      </div>
    </Step>

    <Step title="Create a New App">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>On the My Apps page, click the <strong>Create App</strong> button. In the "Create New App" dialog, fill in the following fields.</p>

        <ul>
          <li><strong>App name</strong> -- A descriptive name for your integration (max 50 characters)</li>
          <li><strong>App description</strong> -- Briefly describe how your app will use the TikTok Ads API (max 500 characters)</li>
          <li><strong>Advertiser redirect URL</strong> -- Enter `https://api.stackone.com/connect/oauth2/tiktokads/callback`</li>
          <li><strong>Scope of permission</strong> -- Select the permissions your app needs (see list below)</li>
        </ul>
      </div>
    </Step>

    <Step title="Select Required Permissions">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>In the <strong>Scope of permission</strong> section, select the following permissions for full connector functionality.</p>

        <ul>
          <li><strong>Ad Account Management</strong> -- Required for reading advertiser account details</li>
          <li><strong>Ads Management</strong> -- Required for campaigns, ad groups, ads, identities, and targeting tools</li>
          <li><strong>Audience Management</strong> -- Required for custom audiences and lookalike audiences</li>
          <li><strong>Reporting</strong> -- Required for performance reports and analytics</li>
          <li><strong>Creative Management</strong> -- Required for uploading and managing images and videos</li>
          <li><strong>Pixel Management</strong> -- Required for tracking pixels</li>
          <li><strong>App Management</strong> -- Required for listing registered mobile apps</li>
        </ul>
      </div>
    </Step>

    <Step title="Submit for Approval">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>Click <strong>Submit</strong> to create the app. TikTok will review your app before it can be used in production.</p>

        <ul>
          <li>App approval typically takes 2-7 business days</li>
          <li>You can use the <strong>Sandbox Ad Account</strong> to test while waiting for approval</li>
          <li>Once approved, the Verification Status will show as <strong>Approved</strong> on the My Apps page</li>
        </ul>
      </div>
    </Step>

    <Step title="Copy App ID and Secret">
      <div data-guide-step data-guide-scopes="" data-guide-display-scopes-list="">
        <p>After approval, click your app name on the My Apps page to open the <strong>App Detail</strong> page. On the <strong>Basic Information</strong> tab, find and copy the <strong>App ID</strong> and <strong>Secret</strong>.</p>

        <ul>
          <li>The Secret is masked by default -- click the eye icon to reveal it, then use the Copy button</li>
          <li>Store both values securely for use later</li>
          <li>You can reset the Secret if needed using the <strong>Reset</strong> link, but this will invalidate existing connections</li>
        </ul>
      </div>
    </Step>
  </Steps>
</section>

## Creating the StackOne Connector Profile

To create the Connector Profile in StackOne for <strong>TikTok Ads</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>TikTok Ads</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>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>TikTok Ads</strong>.
