n8n-nodes-tiktok-v2

This is an n8n community node that lets you use TikTok in your n8n workflows.

TikTok is a popular social media platform for creating, sharing, and discovering short videos. The TikTok Content Posting API allows developers to automate the process of posting content to TikTok directly from their applications.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Compatibility
Usage
Resources
Version history

Installation

Follow the installation guide in the n8n community nodes documentation.

Operations

The TikTok node supports the following operations:

• Video Post: Upload a video via URL or file.
• Photo Post: Upload one or more photos from verified URLs to TikTok, either as a direct post or for later editing in the TikTok app.
• Post Status: Check the publishing status of a post using its publish ID.
• User Profile: Retrieve profile information and statistics for the authenticated user.

Credentials

To use this node, you need to authenticate with TikTok via OAuth2.

1. Create a TikTok Developer account and register an app.
2. Add the Content Posting API product to your app.
3. Obtain the required OAuth2 credentials for the app and configure them in n8n.
4. Ensure your app has been approved for the video.upload, video.publish, and Display API scopes such as user.info.basic, user.info.profile, and user.info.stats.
5. Environment Selection: Choose between Production and Sandbox environments:
   • Production: Use for live TikTok API operations
   • Sandbox: Use for testing and development without affecting production data

Breaking: Updating to v1.1.0 changes the default OAuth scopes. Reauthorize existing TikTok credentials after upgrading.

For detailed instructions on obtaining the credentials, refer to the TikTok API Documentation.

Sandbox Environment

The Sandbox environment allows you to test your integration without affecting production data:

• Uses separate API endpoints (sandbox-open.tiktokapis.com)
• Requires sandbox-specific credentials from TikTok Developer Portal
• All operations work the same as production but with test data
• Ideal for development and testing workflows before going live

Compatibility

• Minimum n8n version: 1.107.0
• Tested against TikTok API versions from 2023.

No known incompatibility issues at this time.

Usage

This node allows you to automate content posting to TikTok by uploading videos or photos directly to TikTok via the Content Posting API. You can configure your workflows to handle uploads, drafts, or deletion of content programmatically.

For new users, check out the Try it out guide for general n8n workflow usage.

Dev Usage

To link to a local n8n instance: (if dev workspace is ~/work/ )
pnpm link ~/work/n8n-nodes-tiktok-v2/

docker run -it --rm
--name n8n
-p 5678:5678
-v n8n_data:/home/node/.n8n
-v ~/work/n8n-nodes-tiktok-v2:/home/node/.n8n/nodes/node_modules/@diendh/n8n-nodes-tiktok-v2
-e "NODE_FUNCTION_ALLOW_EXTERNAL=*"
-e "N8N_SECURE_COOKIE=false"
-e N8N_LOG_LEVEL=debug
docker.n8n.io/n8nio/n8n

To publish a new release:
pnpm publish --access public

Resources

• n8n community nodes documentation
• TikTok API Documentation
• Sandbox Environment Guide - Learn how to use sandbox for testing
• Sandbox Testing Guide - Comprehensive testing instructions

Version history

See CHANGELOG.md