Actions11
Overview
This node enables uploading videos to TikTok directly from n8n workflows. It supports uploading video files either from binary data within the workflow or via a URL. Users can specify metadata such as captions, descriptions, privacy settings, comment permissions, and hashtags for the uploaded video.
Common scenarios where this node is beneficial include:
- Automating social media content publishing by uploading videos to TikTok as part of a larger marketing automation.
- Integrating video uploads into content management systems or digital asset workflows.
- Scheduling or batch uploading multiple videos with custom metadata.
For example, a user could automate uploading a promotional video stored in their workflow's binary data, setting it as public with specific hashtags and a caption, all triggered by an external event.
Properties
| Name | Meaning |
|---|---|
| Content Binary Property | Name of the binary property containing the video file to upload (e.g., "data"). |
| Caption | Text caption to accompany the video on TikTok. |
| Description | Additional description text for the video. |
| Privacy Setting | Privacy level for the video; options are: Public, Friends, Private. |
| Allow Comments | Boolean flag indicating whether comments are allowed on the video. |
| Hashtags | Comma-separated list of hashtags to associate with the video. |
Output
The node outputs JSON data representing the response from TikTok after the upload operation. This typically includes details about the uploaded video such as its ID and status.
The output structure is an array of JSON objects, each corresponding to an input item processed. Each object contains TikTok's API response data under the json field.
No binary data is output by this node during the upload operation.
Dependencies
- Requires an API authentication token credential for TikTok's Open API.
- Uses TikTok's official endpoints for video upload and metadata management.
- The node internally uses HTTP requests with multipart form data for uploading video content.
- No additional environment variables are required beyond the configured TikTok API credentials.
Troubleshooting
- Missing Binary Data: If the specified binary property does not exist on the input item, the node will throw an error indicating the missing binary data property. Ensure the binary property name matches exactly.
- Invalid File Format or Size: The node validates that the video is in MP4 format with H.264 codec and does not exceed 512 MB. Uploads failing these checks will result in errors. Verify your video meets these requirements.
- Rate Limits: TikTok enforces rate limits on API calls. If exceeded, the node will throw a rate limit error advising to wait before retrying.
- Invalid URLs: When uploading from a URL, the node validates the URL format. Invalid URLs cause errors.
- API Errors: Any errors returned by TikTok's API are surfaced with descriptive messages including error codes.
- Network Issues: Network connectivity problems will result in network error messages.
To resolve common issues:
- Confirm binary data presence and correctness.
- Check video format and size compliance.
- Respect rate limits by spacing out requests.
- Validate URLs before use.
- Ensure valid and active TikTok API credentials.
Links and References
- TikTok Open API Documentation
- TikTok Video Upload API Reference (official docs may require login)
- n8n Documentation - Working with Binary Data
- FormData MDN Reference