Description

n8n-nodes-tiktok

This is an n8n community node. It lets you upload videos to TikTok directly from your n8n workflows.

TikTok is one of the world’s most popular social media platforms focused on short-form video content creation and sharing.

n8n is a fair-code licensed workflow automation platform.

Installation
Operations
Credentials
Security
Compatibility
Usage
Rate Limiting
Error Handling
Resources
Version history

Installation

Follow the installation guide in the n8n community nodes documentation.

npm install n8n-nodes-tiktok

Operations

• Upload Video: Upload a video file to TikTok
• Get Upload Status: Check the status of a video upload
• Get Video Info: Retrieve information about an uploaded video
• Delete Video: Remove a video from your TikTok account

Credentials

To use this node, you need to have a TikTok Developer account and create an app to obtain the necessary API credentials.

Prerequisites:

1. Create a TikTok Developer Account
2. Create a new app in the TikTok Developer Portal
3. Enable the Video Upload API for your app
4. Obtain the following credentials:
– Client Key (API Key)
– Client Secret
– Access Token (via OAuth 2.0)

Setting up OAuth 2.0:

1. In your TikTok Developer Portal, set up the OAuth 2.0 redirect URL to match your n8n instance
2. In n8n, add new TikTok API credentials
3. Enter your Client Key and Client Secret
4. Complete the OAuth 2.0 flow to authorize n8n to access your TikTok account

Security

This node implements several security features to protect your data and access:

• Token Encryption: Access tokens are encrypted at rest using industry-standard encryption
• Token Rotation: Automatic token rotation to prevent unauthorized access
• Secure Token Storage: Credentials are securely stored using n8n’s credential management system
• Token Validation: All API requests include token validation to ensure authenticity

For detailed security information and best practices, see SECURITY.md.

Compatibility

• Requires n8n version 1.0.0 or later
• Compatible with TikTok API v2.0
• Tested on n8n versions 1.0.0 – 1.5.0

Usage

Uploading a Video to TikTok

1. Add a “TikTok” node to your workflow
2. Select the “Upload Video” operation
3. Configure the following parameters:
– Video File: Select a file from a previous node or specify a file path
– Caption: Enter text for your video caption
– Description: Add a description for your video
– Privacy Setting: Choose between “Public”, “Friends”, or “Private”
– Allow Comments: Enable or disable comments
– Hashtags: Add relevant hashtags for your video (optional)

Example Workflow

This example workflow demonstrates how to upload a video to TikTok when a new file is added to a specific folder:

1. Use the “Watch Folder” trigger to monitor a directory for new video files
2. Use the “TikTok” node with the “Upload Video” operation
3. Configure the video parameters and connect to your TikTok account
4. Optional: Add a “Slack” node to notify you when the upload is complete

Rate Limiting

The node includes built-in rate limiting features to prevent API quota exhaustion:

• Default limit: 100 requests per hour
• Automatic retry mechanism with exponential backoff
• Maximum of 5 retries per request
• Retry delays: 1-32 seconds (exponential)
• Real-time rate limit monitoring using TikTok API headers

For troubleshooting rate limiting issues, see TROUBLESHOOTING.md.

Error Handling

The node implements comprehensive error handling:

• Detailed error messages with specific error codes
• Automatic retry for recoverable errors
• Rate limit handling with backoff strategy
• Network error recovery
• Validation of API responses

Common errors and their solutions are documented in TROUBLESHOOTING.md.

Resources

• n8n community nodes documentation
• TikTok Developer Documentation
• TikTok API Reference
• Security Documentation
• Troubleshooting Guide

Version history

1.0.0 (2025-05-09)

• Added comprehensive security features:

– Token encryption and rotation
– Secure credential storage
– Token validation

• Implemented real API integration:

– Type-safe requests
– Response validation
– Error handling

• Added reliability features:

– Rate limiting with automatic retries
– Network error recovery
– Comprehensive error handling

0.1.0 (2025-05-09)

• Initial release with video upload functionality
• Support for basic video metadata
• OAuth 2.0 authentication implementation