TikTok icon

TikTok

Crie e gerencie posts no TikTok

Actions4

Overview

This node allows you to create a new post on TikTok by associating it with an existing video. It is useful for automating content publishing workflows, scheduling posts, and managing post metadata such as captions, privacy settings, and engagement options.

Typical use cases include:

  • Automatically posting videos uploaded earlier to TikTok.
  • Scheduling posts to be published at a specific date and time.
  • Setting privacy levels and controlling whether comments are allowed.
  • Marking posts as branded content or adding background music.

For example, you can create a post with a caption and schedule it to go live tomorrow while disabling comments and marking it as sponsored content.

Properties

Name Meaning
Video ID The unique identifier of the video to be posted.
Caption Text caption or description to accompany the post.
Schedule Time (Optional) Date and time to schedule when the post should be published.
Privacy Level (Optional) Visibility of the post; options: Public, Friends, Private.
Allow Comments (Optional) Whether comments are enabled on the post; true or false.
Brand Content (Optional) Indicates if the post is sponsored content; true or false.
Music (Optional) ID of the music track to be used in the video post.

Output

The node outputs JSON data representing the created post's details as returned by the TikTok API. This typically includes identifiers, status, timestamps, and any metadata related to the post creation.

No binary data output is produced by this operation.

Dependencies

  • Requires an active TikTok API authentication credential configured in n8n.
  • The node communicates with TikTok’s official API endpoints, switching between production and sandbox environments based on credential configuration.
  • Proper API permissions must be granted to create posts on behalf of the user.

Troubleshooting

  • Missing or invalid Video ID: Ensure the provided Video ID corresponds to an existing uploaded video on TikTok. Invalid IDs will cause the API request to fail.
  • Authentication errors: Verify that the TikTok API credentials are correctly set up and have sufficient permissions.
  • Scheduling issues: If scheduling a post, ensure the scheduled time is in the future and formatted correctly.
  • Privacy level or other option errors: Use only the supported values for privacy ("public", "friends", "private") and boolean fields.
  • API rate limits or network errors: These may cause failures; retry after some time or check network connectivity.

Error messages from the TikTok API usually indicate the cause, such as invalid parameters or authorization failures. Review the error details and adjust input properties accordingly.

Links and References

Discussion