📘 TikTok Integration with Our App

The TikTok Integration allows users to securely connect their TikTok accounts to Our App for login authentication, profile insights, and direct video publishing.
This document explains both Sandbox (testing) and Live (production) setups for smooth integration and easy TikTok App review approval.

---

🔹 Sandbox Integration

1. Create a TikTok App

1. Go to TikTok for Developers.

2. Select Manage Apps → Connect an App.

3. Choose Individual Developer for Sandbox mode.

4. Name the app (e.g., Our App TikTok Sandbox).

---

2. Create a Sandbox

1. Open the Sandbox tab → click Create Sandbox.

2. Enter a name (e.g., Our App Sandbox).

3. Copy the generated Client Key and Client Secret.

---

3. Configure App Details

---

4. Add Products

Add the following under Products:

• Login Kit → Add Redirect URI:

  https://yourdomain.com/app/tiktok/profile


• Content Posting API → Enable Direct Post and verify your domain.

---

5. Configure Scopes

Use only the scopes required for login, analytics, and publishing:

🔸 video.upload is not used — videos are published directly through the TikTok API using video.publish.

---

6. Add Target Users (Sandbox Only)

1. Go to Sandbox → Target Users.

2. Add your TikTok test accounts here.
   Only these accounts can connect during Sandbox testing.

---

7. Configure in Our App

Go to Settings → API Integration → TikTok.
Enter:

• App ID

• App Secret

• Callback URL

• Scopes (listed above)

• Mode = Sandbox

Click Save.

---

8. Connect TikTok in Our App

1. Open Channels → + Add Channel.

2. Select TikTok → + Profile.

3. Log in with TikTok and grant requested permissions.

4. Your TikTok profile will appear under Connected Channels.

---

9. Troubleshooting Sandbox

---

🔹 Live Integration

1. Requirements Before Review

• Must be an Organization account.

• Domain must be verified.

• Public Privacy Policy and Terms pages are required.

• App icon and description should clearly explain usage.

---

2. Domain Verification

Choose one of the following:

• Add the DNS TXT record provided by TikTok, or

• Upload the tiktok-verification.txt file to your website root (e.g.,
  https://yourdomain.com/tiktok-verification.txt).

---

3. Products & Scopes for Live

Products:

• Login Kit

• Content Posting API

Scopes:

---

4. Explain Usage of Products & Scopes

Use this clear, reviewer-approved description:

Our App integrates TikTok to allow users to log in, view account analytics, and publish videos directly.

• Login Kit → Provides secure OAuth login.

• Content Posting API → Enables users to publish videos directly to TikTok.

• user.info.basic → Identifies the TikTok account (name, avatar, open_id).

• user.info.profile → Displays profile info like bio and verification status.

• user.info.stats → Shows follower count, total likes, and video metrics for analytics.

• video.list → Displays existing videos posted by the connected TikTok account.

• video.publish → Publishes videos from our app directly to TikTok (no draft uploads).

---

5. Prepare a Demo Video

Record a 1–2 minute demo video showing:

1. Logging into Our App

2. Adding a TikTok channel

3. OAuth login & granting permissions

4. TikTok profile connected successfully

5. Publishing a video → appears on TikTok profile

Upload it to YouTube, Vimeo, or Google Drive (public link).

---

6. Submit for Review

In TikTok Developer Portal → App → Review:

• Add app details

• Include scopes explanation (above)

• Provide the demo video link

• Submit and wait for TikTok’s feedback (3–7 business days)

---

7. After Approval

• Switch your app mode to Live in TikTok Developer Portal.

• In your app → Settings → API Integration → TikTok → Mode = Live.

• Test connection with a real TikTok account.

---

8. Best Practices for Live

✅ Do:

• Use HTTPS everywhere.

• Match callback domains exactly.

• Keep Privacy Policy & Terms pages public.

• Request only necessary scopes.

• Respond quickly to reviewer questions.

❌ Don’t:

• Include video.upload if not used.

• Leave placeholder URLs.

• Use personal accounts for production testing.

---

✅ Final Result

After successful review and approval:

• Users can log in securely via TikTok

• View TikTok profile & stats inside Our App

• Publish videos directly to TikTok through the Content Posting API