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

# TikTok

> Post videos and photos, send drafts to the TikTok app, and report on your account and videos.

![TikTok](https://mintcdn.com/ruby-ai/NhidLBbC08Lp9khb/branding/integrations/tiktok.svg?fit=max\&auto=format\&n=NhidLBbC08Lp9khb\&q=85\&s=dbab56481c759d25a3843a2f0522431b)

> [!NOTE]
>
> TikTok is in preview. Ruby enables it per workspace. If the tool is missing, use your Ruby support channel to request access.

Let agents post your videos and photos on TikTok, send drafts to the TikTok app, and report on your account and videos.

## Connect

1. Go to **Spaces → Tools** (workspace admins) and add **TikTok**.
2. Click **Connect** and sign in with TikTok. Admins connect a shared brand account for everyone, or let each person connect their own account.
3. Add the tool to the agents that need it.

To remove Ruby's access, remove Ruby from the apps and services connected to your account in the TikTok app's security settings.

## Tools

| Tool | Description | Asks before running |
| - | - | - |
| Get TikTok profile | Name, username, bio, followers, likes and video count | Runs automatically |
| List TikTok videos | Your latest public videos with views, likes, comments and shares | Runs automatically |
| Get video stats | Latest numbers of videos by id | Runs automatically |
| View TikTok video | Cover image and link of one of your videos | Runs automatically |
| Get creator info | Privacy options, interactions and longest video the account can post | Runs automatically |
| Get post status | Whether a post or draft is processing, published or failed | Runs automatically |
| Post video | Post a conversation video on your account | Asks every time |
| Send video draft | Send a conversation video to your TikTok inbox to finish in the app | Asks every time |
| Post photos | Post up to 35 conversation photos as a photo post | Asks every time |
| Send photo draft | Send conversation photos to your TikTok inbox to finish in the app | Asks every time |

## Asks before running

Every tool listed above is available. This column describes whether the agent asks you before using it.

| Value | Meaning |
| - | - |
| Runs automatically | Reads data. The agent uses it without asking. |
| Asks once | The agent asks the first time. You can approve it for good. |
| Asks per recipient / Page / account | The agent asks for each new recipient, Page or account. You can approve it for good for that one. |
| Asks every time | Publishes, deletes, spends money or messages people outside a conversation. The agent asks each time. |

## Review before posting

Before anything is sent to TikTok, Ruby shows you the post in the conversation:

* The TikTok account it goes to, and the media.
* The caption (and description for photos), which you can edit.
* **Who can see this post**: you choose; nothing is selected for you.
* **Allow users to** comment, duet or stitch: off until you turn them on, and unavailable when they are off in your TikTok settings.
* **Disclose commercial content**: say whether the post promotes your brand, another brand, or both. TikTok labels it "Promotional content" or "Paid partnership". Branded content can't be private.

Posting means you agree to TikTok's Music Usage Confirmation (and its Branded Content Policy for branded content). TikTok takes a few minutes to process a post before it appears on your profile: ask the agent for the post status.

## Good to know

* Videos come from the conversation (see [Videos](https://docs.ruby.ad/docs/user-documentation/data-sources/conversation-files/videos.md)). Ruby sends TikTok a web-ready copy and adds nothing to it: no watermark, no branding.
* TikTok accepts videos up to the length your account allows (usually 10 minutes), and JPEG or WebP photos up to 20 MB.
* Drafts appear as a notification in the TikTok app, where you finish and post them. TikTok allows 5 pending drafts per day.
* TikTok does not share video files: agents can see your videos' covers, titles and numbers, not download or transcribe them.
* Until TikTok reviews Ruby's app, posts can only be private ("Only me").

## What is not supported

* Comments and messages: TikTok has no API for them.
* Other people's accounts: agents only see the connected account.

For advertising campaigns and performance reporting, see [TikTok Ads](https://docs.ruby.ad/docs/user-documentation/agents/tools/tiktok-ads.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.