Description
n8n-nodes-tiktok-business
This is an n8n community node. It lets you use TikTok Business API in your n8n workflows.
TikTok Business API is a comprehensive platform that allows advertisers to programmatically manage their TikTok advertising campaigns, creative assets, and account information.
n8n is a fair-code licensed workflow automation platform.
Installation
Operations
Credentials
Compatibility
Usage
Resources
Installation
Follow the installation guide in the n8n community nodes documentation.
Operations
User Actions
- Get User Info: Retrieve up-to-date information about the authenticated user
Advertiser Actions
- Get Authorized Ad Accounts: Retrieve all ad accounts that the authenticated user has access to
- Get Ad Account Details: Get detailed information about specific advertiser accounts
Image Actions
- List Images: Retrieve a paginated list of images in an advertiser account
- Get Info About Images: Get detailed information about specific images
- Update Image Name: Rename an existing image in your account
- Upload Image: Upload new images to your TikTok Business account from binary data, URLs, or file IDs
Creative Tool Actions
- Delete Creative Assets: Remove images and videos from your creative asset library
- Edit an Image: Modify images using various editing methods (fix size, gaussian padding, etc.)
Credentials
This node supports two authentication methods:
OAuth2 Authentication
- Create a TikTok Business API application in the TikTok for Business Developer Portal
- Obtain your Client ID and Client Secret
- Configure the OAuth2 redirect URL in your TikTok app settings
- Use the "TikTok Business OAuth2 API" credential type in n8n
Easy Auth (Simplified OAuth2)
- Use the "TikTok Business Easy Auth OAuth2 API" credential type
- Provide the authorization URL, access token URL, and advertiser get URL
- This method is useful for custom OAuth2 implementations or when using pre-configured endpoints
Cookie Authentication
- Use the "TikTok Business Cookie API" credential type
- Provide the CSRF token and session ID
Prerequisites:
- A TikTok Business account
- A registered application in the TikTok for Business Developer Portal
- Appropriate permissions for the operations you want to perform
Compatibility
- Minimum n8n version: 1.100.0
- Tested with n8n versions: 1.100.0+
- Node.js version: 20.15+
- TikTok Business API versions: v1.2, v1.3 (default)
Usage
Basic Workflow Examples
Getting Started:
- Set up your TikTok Business API credentials
- Use "Get Authorized Ad Accounts" to retrieve your advertiser IDs
- Use the advertiser ID in subsequent operations
Image Management:
- Upload images from your workflow using binary data or URLs
- List and manage your creative assets
- Edit images programmatically with various methods
Account Management:
- Retrieve user information and account details
- Get comprehensive advertiser account information including contact details, balance, and settings
Important Notes
- Some operations require specific advertiser permissions
- Image uploads support multiple formats and methods (binary data, URLs, file IDs)
- The node supports both v1.2 and v1.3 of the TikTok Business API
- Rate limits apply according to TikTok's API documentation
