TikTok short-form video platform + creation tools + social sharing
TikTok short-form video platform + creation tools + social sharing On Nagent, Tiktok is exposed as a fully-configurable social media accounts integration that any agent can call — 10 actions, and OAuth authentication. No code is required to wire Tiktok into your workflow — connect it once via the External Integrations panel and reuse it across every agent you build.
Agent builders use Tiktok to automate the kinds of tasks social media accounts teams previously handled manually. Concrete examples — each one is a single agent step in Nagent — include:
Every action and trigger is paired with a structured input/output schema (visible in the sections below), so when you wire Tiktok into Helix — our agentic agent builder — the editor knows exactly what each step expects and produces. Configure once, deploy anywhere across your Nagent agents.
Every operation an agent can call against Tiktok, with input parameters and output schema. Drop these into any step of an agent built in Helix.
TIKTOK_FETCH_PUBLISH_STATUSCheck the processing status of a TikTok video or photo post using its publish_id. Use this action to poll the status of content after initiating an upload or post. The API returns detailed information about processing stages (upload, download, moderation) and any errors that occurred. Non-terminal statuses mean processing is still pending — never re-initiate TIKTOK_PUBLISH_VIDEO for the same publish_id. Use exponential backoff when polling (e.g., 5s→10s→20s) to avoid the 30 requests/minute per access token rate limit.
Input parameters
The unique identifier (max 64 characters) returned from a video upload or photo post initialization. Used to track the posting action and check its processing status.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIKTOK_GET_ACTION_CATEGORIESTool to retrieve available action categories from TikTok Marketing API. Use when you need to get the list of conversion event categories for creating or managing TikTok ad campaigns with conversion tracking.
Input parameters
Language for category names in the response. Defaults to English (en).
Advertiser ID for which to retrieve action categories.
Special ad categories for restricted industries.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIKTOK_GET_TERMTool to retrieve terms from TikTok Business API. Use when you need to fetch advertiser or agency terms for a specific advertiser ID.
Input parameters
Language code for the terms. Default is 'EN' (English).
Type of terms to retrieve. ADVERTISER_TERMS for advertiser terms, AGENCY_TERMS for agency terms.
The advertiser ID for which to retrieve terms.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIKTOK_GET_USER_STATSFetches TikTok user information and statistics for the authenticated user. Retrieves user stats (follower_count, following_count, likes_count, video_count) and can optionally fetch profile fields (display_name, username, bio_description, etc.) and basic info (open_id, union_id, avatar URLs). Returns only the fields requested in the fields parameter. Only works for the authenticated account; cannot fetch arbitrary public profiles. Stats may be delayed and not reflect the most recent activity.
Input parameters
List of fields to retrieve. Available fields: Stats fields (user.info.stats scope): follower_count, following_count, likes_count, video_count. Profile fields (user.info.profile scope): display_name, username, bio_description, profile_deep_link, is_verified. Basic fields (user.info.basic scope): open_id, union_id, avatar_url, avatar_url_100, avatar_large_url. Defaults to the 4 statistics fields. Requesting fields without the corresponding OAuth scope returns missing or incomplete data for those fields.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIKTOK_LIST_GMV_MAX_OCCUPIED_CUSTOM_SHOP_ADSTool to get GMV Max occupied custom shop ads list for a TikTok advertiser. Use this action when you need to retrieve information about which custom shop ads are currently occupied for GMV Max campaigns. This is part of the TikTok Business API and requires appropriate advertiser access.
Input parameters
The store ID to filter occupied custom shop ads.
Comma-separated list of asset IDs to check for occupation status.
The advertiser ID for which to retrieve occupied custom shop ads.
The type of asset to check (e.g., VIDEO, IMAGE).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIKTOK_LIST_VIDEOSLists videos for the authenticated user (or specified creator). Does not provide a global TikTok-wide feed.
Input parameters
Pagination cursor (UTC Unix timestamp in milliseconds) returned from previous call's response. Stop pagination when no next cursor is returned.
Maximum number of videos to retrieve per page. Default is 10, maximum is 20.
Optional creator open_id to list videos for a specific creator. Omit to list videos for the authenticated user.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIKTOK_POST_PHOTOCreate a photo post (1-35 images) on TikTok via Content Posting API. Supports two modes: - MEDIA_UPLOAD: Uploads photos to user's inbox for review/editing before posting - DIRECT_POST: Immediately posts photos to user's TikTok account IMPORTANT: Photo URLs must be from your TikTok-verified domain. Unverified domains will return 403 Forbidden. Unaudited apps can only post with privacy='SELF_ONLY'. Rate limit: 6 requests per minute per user access token. Reference: https://developers.tiktok.com/doc/content-posting-api-reference-photo-post
Input parameters
Post title (<= 90 UTF-16 runes)
Use DIRECT_POST to publish immediately (requires video.publish), or MEDIA_UPLOAD to send to inbox for editing (requires video.upload)
Post description (<= 4000 UTF-16 runes)
List of 1-35 publicly accessible HTTPS image URLs (JPG, JPEG, or WEBP format). IMPORTANT: URLs must be from your TikTok-verified domain or URL prefix. Random/third-party URLs will be rejected with 403 error.
Privacy level for the photo post. Required for DIRECT_POST mode. Common values: 'SELF_ONLY' (private), 'MUTUAL_FOLLOW_FRIENDS' (friends), 'FOLLOWER_OF_CREATOR' (followers), 'PUBLIC_TO_EVERYONE' (public). For unaudited apps, must use 'SELF_ONLY'.
DIRECT_POST only. Auto add recommended music.
DIRECT_POST only. Disallow comments if true.
Zero-based index (0 to len(photo_images)-1) indicating which image to use as the cover/thumbnail
DIRECT_POST only. True if content is a paid partnership to promote a third-party business.
DIRECT_POST only. True if content promotes the creator's own business.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIKTOK_PUBLISH_VIDEOPublishes a video to TikTok by pulling it from a public URL. TikTok downloads the video from the provided URL and publishes it directly to the creator's profile. Publishing is asynchronous — after calling this action, poll TIKTOK_FETCH_PUBLISH_STATUS with the returned publish_id to check completion. For uploading video files instead of URLs, use TIKTOK_UPLOAD_VIDEO.
Input parameters
Optional caption/title text for the video post. Maximum length: 2200 UTF-16 characters.
A publicly accessible URL of the video to publish. TikTok will pull the video from this URL. Must be HTTP/HTTPS. The video will be downloaded by TikTok's servers, so ensure the URL is accessible and not behind authentication.
Whether to disable duets on the video.
Privacy level for published video. Options: SELF_ONLY, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, PUBLIC_TO_EVERYONE. For unaudited apps, use SELF_ONLY or MUTUAL_FOLLOW_FRIENDS.
Whether to disable stitches on the video.
Whether to disable comments on the video.
Timestamp in milliseconds to use as video cover/thumbnail.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIKTOK_UPLOAD_VIDEOUploads a video to TikTok via the Content Posting API (init + single-part upload). This action initializes an upload session to obtain a presigned upload URL, then uploads the entire file with a single PUT request. Use a subsequent action to publish the post. Ensure the video file is fully generated and available before calling this action.
Input parameters
Optional caption/title used when publish=true
If true, attempts to publish after upload using the returned publish_id.
Whether to disable duets on the video.
Privacy level for published video. Options: SELF_ONLY, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, PUBLIC_TO_EVERYONE. For unaudited apps, use SELF_ONLY or MUTUAL_FOLLOW_FRIENDS.
Whether to disable stitches on the video.
Video file to upload to TikTok. Supported formats include MP4, MOV, WEBM. Must be a structured dict with fields: name (filename), mimetype (e.g. video/mp4), and s3key (S3 object key). Local file paths and raw bytes are not accepted. Recommended aspect ratio 9:16.
Whether to disable comments on the video.
Chunk size for multi-part uploads in bytes (1MB-64MB). If not provided, defaults to file size for single-chunk upload. Most videos can use default (None).
Timestamp in milliseconds to use as video cover/thumbnail (e.g., 1000 for 1 second into video).
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
TIKTOK_UPLOAD_VIDEOSUploads multiple videos to TikTok concurrently (init + single-part upload per file).
Input parameters
Optional caption/title used when publish=true
If true, attempts to publish after each upload using direct publish flow.
Maximum number of parallel uploads
Whether to disable duets on the videos.
Privacy level for published videos. Options: SELF_ONLY, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, PUBLIC_TO_EVERYONE.
Whether to disable stitches on the videos.
Whether to disable comments on the videos.
List of video files to upload to TikTok in parallel. Supports common video formats like MP4, MOV, WebM. Each file must not exceed TikTok's size/duration limits; oversized, too-long, or unsupported-codec files are rejected. Caption (via `caption`) must also be within TikTok's length limit.
Chunk size hint for multi-chunk uploads (bytes, 1MB-64MB). For single-chunk uploads, automatically uses file_size if not provided.
Timestamp in milliseconds to use as video cover/thumbnail.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
No publicly available marketplace agent is found using this tool yet. There are 44 agents privately built on Nagent that already use Tiktok.
Build on Nagent
Connect Tiktok to any Nagent agent in minutes — no API key management, no boilerplate. Just configure and deploy.
The five questions agent builders ask before adopting a new integration.
Open the External Integrations panel inside Nagent (app.nagent.ai/externalIntegration), find Tiktok, and click "Connect Now." You'll authenticate with OAuth — Nagent handles credential storage and refresh automatically. Once connected, Tiktok is available to any agent in your workspace.
No. Nagent provides no-code integration for every tool. Once Tiktok is connected, you configure its 10 actions directly in the agent builder UI — no API calls, no boilerplate, no schema management.
Helix — Nagent's agentic agent builder — lets you drop Tiktok steps into any workflow visually. Pick an action (e.g., one of those listed above), fill in the inputs (Helix knows the required vs. optional schema for each parameter), and connect it to upstream/downstream steps. Triggers run as the entry point of an agent, so when a Tiktok event fires, the agent kicks off automatically.
Every Tiktok action and trigger ships with a fully-typed schema — input parameters with name, type, required flag, and description, plus the output payload shape. The schemas are documented in the sections above. Helix uses these schemas to validate your configuration at build time and to type-check the data flowing between steps.
Yes. While Tiktok ships with 10 pre-built social media accounts actions, you can layer custom logic around them inside Helix — pre/post-processing steps, conditional branches, retries, or stitching Tiktok together with other connected tools. For deeper customization, talk to our team about Nagent's Agentic AI Lab — forward-deployed engineers who build Tiktok-based workflows tailored to your business.