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

# TikTok

> Set up and use the TikTok integration with Hyper AI

Auth type: OAuth

<Info>
  For general setup steps, permissions, and troubleshooting, start with: [App Integrations](/integrations/overview).
</Info>

## Connect TikTok

1. Go to Settings → Apps in Hyper
2. Select TikTok → Connect New
3. Complete OAuth and grant requested scopes

## Common capabilities

* Create and manage TikTok content
* Automate posting and content scheduling
* Monitor engagement and performance metrics

## Use in Chat

Enable TikTok in the tool selector. Ask your agent to draft content, check analytics, or manage your profile.

## Use in Agents

Add TikTok to an agent's toolkits and select the connection. Require approval for publish actions.

## Use in Flows

Automate content publishing, engagement tracking, and reporting using TikTok action nodes.

## Troubleshooting

* Content not posting: verify OAuth scopes and account permissions
* API rate limits: reduce frequency of actions or add delays in flows

***

## Available Actions

Hyper agents can run the following actions for this integration. Each action can be individually set to **Enabled**, **Requires Approval**, or **Disabled** in your agent's toolkit settings.

Actions can be set to one of three control states:

| State                 | Behavior                                                       |
| --------------------- | -------------------------------------------------------------- |
| **Enabled**           | Agent runs the action automatically                            |
| **Requires Approval** | Agent pauses and waits for your confirmation before proceeding |
| **Disabled**          | Action is blocked and cannot be used                           |

Configure these in the agent's toolkit settings or in workspace defaults.

| Action                 | Description                                                                                         |
| ---------------------- | --------------------------------------------------------------------------------------------------- |
| Get Post Status        | Check the upload and publishing status of a TikTok video or photo post                              |
| Get User Info          | Get comprehensive TikTok user information for the authenticated user                                |
| List Videos            | Get a paginated list of the authenticated user's public TikTok videos                               |
| Open Post Form         | Opens the interactive TikTok posting form. ALWAYS use this when a user wants to post to TikTok      |
| Post Photos            | Post one or more photos to TikTok as a photo post or carousel using the Content Posting API         |
| Post Video From File   | Post a video to TikTok directly from a local file using the Content Posting API                     |
| Post Video From Url    | Post a video to TikTok directly from a URL using the Content Posting API                            |
| Query Creator Info     | Query TikTok creator information and posting capabilities for the authenticated user                |
| Query Videos           | Query specific TikTok videos by their IDs to get detailed information and refresh cover image URLs  |
| Upload Photos          | Upload one or more photos to TikTok creator's inbox as a draft for manual review and posting        |
| Upload Video From File | Upload a video to TikTok creator's inbox as a draft from a local file for manual review and posting |
| Upload Video From Url  | Upload a video to TikTok creator's inbox as a draft from a URL for manual review and posting        |