> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lovable.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect your app to TikTok

> Connect your app to TikTok to read creator profiles, fetch published videos, and build social integrations from your Lovable app. 

export const connector_0 = "TikTok"

[TikTok](https://www.tiktok.com/) is a short-form video platform with APIs for accessing creator profiles and content. The TikTok connector lets your Lovable app read account profile data, access video metadata, and build creator workflows that rely on TikTok account information.

With TikTok, your app can:

* Read basic profile data including display name and account ID
* Access follower counts, like counts, and video statistics
* Read extended profile details such as bio and avatar
* Fetch a list of published videos and their metadata

The TikTok connector is read-only and connects to a single TikTok account via OAuth. It's a good fit for creator tools, social dashboards, content portfolios, and analytics apps built around a specific TikTok account.

## Common use cases and example apps

| **Example app**             | **Example prompt**                                                                                                                  | **Description**                                                                                                                                                                                        |
| :-------------------------- | :---------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Creator analytics dashboard | *Use TikTok and build a dashboard that shows my follower count, total likes, and video performance over time.*                      | **Surface TikTok account metrics in a focused dashboard.**<br />The app reads profile stats and video data, displays trends over time, and gives a creator a single place to track growth.             |
| Video portfolio site        | *Use TikTok and build a portfolio page that displays my published TikTok videos with titles and view counts.*                       | **Showcase a creator's TikTok content on a custom website.**<br />The app fetches the list of published videos and renders them alongside metadata such as titles, thumbnails, and engagement counts.  |
| Campaign tracker            | *Use TikTok and build a campaign tracker that stores TikTok video metadata for sponsored posts and links them to campaign records.* | **Track campaign content tied to a connected TikTok account.**<br />The app reads published video metadata, matches videos to campaigns, and keeps reporting data organized in one place.              |
| Content management tool     | *Use TikTok and build a tool that lets me review my published TikTok videos, add internal notes, and tag them by campaign.*         | **Build a lightweight content management layer on top of published TikTok videos.**<br />The app lists videos fetched from TikTok and lets you add custom fields, tags, or notes stored separately.    |
| Profile sync utility        | *Use TikTok and build a utility that syncs my TikTok display name and account identifiers into my CRM records.*                     | **Keep internal systems aligned with TikTok account details.**<br />The app reads profile data from the connected TikTok account and writes it to the appropriate CRM fields to reduce manual updates. |

## How to connect TikTok

Workspace admins and owners can connect TikTok. You can create multiple TikTok connections using different accounts, which is useful for separating environments or managing multiple creators.

When the connection is created, TikTok becomes available across all projects in the workspace. Anyone building in a project can ask Lovable in chat to link their project to it.

### Prerequisites

Before connecting TikTok, make sure you have:

* A TikTok account you want to connect (you can also create one during the OAuth flow)
* Lovable workspace **owner** or **admin** role

<Note>
  All API requests made through this connector consume TikTok API units according to your TikTok plan. Billing and quota are handled directly by TikTok, not Lovable.
</Note>

### Set up your TikTok connection

<Steps>
  <Step title="Open TikTok in Connectors">
    Go to **Connectors → App connectors** and select **TikTok**.
  </Step>

  <Step title="Add a connection">
    Click **Add connection**.
  </Step>

  <Step title="Name the connection">
    In **Display name**, name the connection (for example, `My TikTok`). This name is only used inside Lovable to identify the connection.
  </Step>

  <Step title="Review scopes (optional)">
    Expand **Advanced settings** to review the permissions your app will request. Default scopes are pre-selected for common use cases.  Scopes control what data the connection can access. All four scopes are selected by default.

    You can remove any optional scope, except **Read basic profile information**, which is required and cannot be removed.

    | **Scope**                                               | **Description**                             |
    | :------------------------------------------------------ | :------------------------------------------ |
    | Read basic profile information (`user.info.basic`)      | Display name and account ID                 |
    | Read user stats (`user.info.stats`)                     | Follower count, like count, and video count |
    | Read extended profile information (`user.info.profile`) | Bio, avatar, and profile details            |
    | Read published video metadata (`video.list`)            | List of published videos and their metadata |

    For full scope documentation, see [TikTok's API scopes reference](https://developers.tiktok.com/doc/tiktok-api-scopes/).
  </Step>

  <Step title="Choose who can access this connection">
    Under **Who can access this connection**, decide who in your workspace can use the connection:

    * **Only you** (default): only the person creating the connection can use it and its associated data.
    * **Invite specific people**: only you and explicitly added workspace members can use the connection and its associated data.
    * **Invite entire workspace**: click **Invite entire workspace** to make the connection available to everyone in your Lovable workspace.

    See [**Who can manage connections**](/integrations/introduction#who-can-manage-connections) for more information.
  </Step>

  <Step title="Connect to TikTok and authorize">
    Click **Connect**. The TikTok authorization window opens, so make sure your browser doesn’t block pop-ups. If it does, Lovable redirects you instead.

    Sign in to TikTok if prompted, review the requested permissions, and click **Allow**.

    You’ll be redirected back to Lovable with a confirmation.
  </Step>
</Steps>

When connected, anyone building in a project can ask Lovable in chat to link their project to TikTok (based on configured connection-level access). Your Lovable apps can then start reading TikTok profile data and video content.

## Limitations

The TikTok connector is read-only. It cannot:

* Upload or publish videos to TikTok
* Access private videos or draft content
* Read comments, DMs, or notifications
* Manage followers or interact with other accounts
* Receive TikTok webhooks or real-time events
* Support per-end-user TikTok login. Each connection represents a single TikTok account shared across all projects linked to it.

If TikTok authorization is revoked from the TikTok side, you'll need to reconnect the integration in Lovable before API calls can succeed again.

## How to unlink projects from a {connector_0} connection

Editors and above can remove specific projects from a connection without deleting the connection entirely. The connection will remain available for other projects.

To unlink projects:

<Steps>
  <Step title="Open Connectors">
    Open **Connectors**, then go to **App connectors**, and select **{connector_0}**.
  </Step>

  <Step title="Open the connection">
    Open the connection you want to manage.
  </Step>

  <Step title="Select projects">
    Under **Linked projects**, check the projects you want to unlink.
  </Step>

  <Step title="Confirm">
    Click **Unlink projects** and confirm.
  </Step>
</Steps>

When unlinked, those projects will no longer have access to {connector_0} through this connection. If a project needs {connector_0} again, you can link it to any available connection.

## How to delete a {connector_0} connection

Workspace admins and owners can delete {connector_0} connections. Other members can delete a connection if they created it, or if they have been explicitly granted access to it.

<Warning>
  Deleting a connection is permanent and cannot be undone. It will remove the credentials from all linked projects, and any apps using this connection will stop working until a new connection is added.
</Warning>

Before deleting, review the **Linked projects** section to see which projects are currently using the connection.

To delete a connection:

<Steps>
  <Step title="Open Connectors">
    Open **Connectors**, then go to **App connectors**, and select **{connector_0}**.
  </Step>

  <Step title="Open the connection">
    Open the connection you want to remove.
  </Step>

  <Step title="Review linked projects">
    Review the **Linked projects** section.
  </Step>

  <Step title="Delete">
    Under **Delete this connection**, click **Delete** and confirm.
  </Step>
</Steps>