Requirements
Before you set up the credential, make sure you have an active TikTok Ads account and OAuth client credentials, granted by signing in with your account ready.[3]https://ads.tiktok.com
Get your TikTok Ads credentials
You’ll be redirected to sign in and approve access — your password is never shared with WEXTL.
Connect TikTok Ads in WEXTL
- Log in to your WEXTL account, add the TikTok Ads node module to your workflow, and click Create new credential.Instant triggers use webhooks — click Create a webhook first when adding one, then create the credential.
- Optional: In the Credential name field, enter a name for the credential.
- Enter the authentication credentials you copied from your TikTok Ads account, or follow the on-screen instructions to create the credential.
- If prompted, authenticate your account and confirm access.
- If you want to make changes to your credential in the future, follow the steps in Manage credentials →
Notes
Credentials are org-scoped; share them with teammates from the Credentials picker on any of its nodes.For detailed information on connecting an application, see Connect an application →
TikTok Ads node modules
The list below is a reference of every TikTok Ads node module the integration supports. You will be able to pick any of them on the workflow canvas while building automations.
Each TikTok Ads node module below opens to reveal its input parameters, outputs, and connection requirements.
Output fields[3]
| Field | Type |
|---|---|
Ad Account ID | text |
Ad Account Name | text |
Business Center ID | text |
Status | text |
Status Changed At | text |
Suspension Reason | text |
Subscription ID | text |
Output fields[3]
| Field | Type |
|---|---|
Request ID | text |
Object Type | number |
Entries | array |
Sent At | text |
Output fields[3]
| Field | Type |
|---|---|
Request ID | text |
Object Type | number |
Entries | array |
Sent At | text |
Output fields[3]
| Field | Type |
|---|---|
Request ID | text |
Object Type | number |
Entries | array |
Sent At | text |
Output fields[3]
| Field | Type |
|---|---|
Request ID | text |
Object Type | number |
Entries | array |
Sent At | text |
Output fields[3]
| Field | Type |
|---|---|
Request ID | text |
Object Type | number |
Entries | array |
Sent At | text |
Output fields[3]
| Field | Type |
|---|---|
Request ID | text |
Object Type | number |
Entries | array |
Sent At | text |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Limit | number |
Fields | array |
Filter | object |
Ad Groups | choice |
Campaigns | choice |
Ad Group Name | text |
Campaign Automation Type | choice |
Advertising Objective | text |
Primary Status | choice |
Secondary Status | text |
Buying Types | choice |
Optimization Goal | text |
Promotion Type | choice |
Output fields[3]
| Field | Type |
|---|---|
Advertiser ID | text |
Campaign ID | text |
Campaign Name | text |
Ad Group ID | text |
Ad Group Name | text |
Created At | text |
Modified At | text |
Status | text |
15other output fields
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Limit | number |
Fields | array |
Filter | object |
Ads | choice |
Ad Groups | choice |
Campaigns | choice |
Upgraded Smart+ Ad IDs (v2) | array |
Campaign Automation Type | choice |
Advertising Objective | text |
Primary Status | choice |
Secondary Status | text |
Buying Types | choice |
Optimization Goal | text |
Output fields[3]
| Field | Type |
|---|---|
Advertiser ID | text |
Campaign ID | text |
Campaign Name | text |
Ad Group ID | text |
Ad Group Name | text |
Ad ID | text |
Ad ID (v2) | text |
Ad Name | text |
12other output fields
Input fields[3]
| Field | Type |
|---|---|
Business CenterRequired | choice |
Asset TypeRequired | choice |
Limit | number |
Filter | object |
User ID | text |
User Email | text |
Keyword | text |
Output fields[3]
| Field | Type |
|---|---|
Asset Type | text |
Asset ID | text |
Asset Name | text |
Ad Account Type | text |
Ad Account Role | text |
Catalog Role | text |
Ad Creation Eligible | text |
TikTok Shop Role | text |
7other output fields
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
AudiencesRequired | choice |
History Size | number |
Output fields[3]
| Field | Type |
|---|---|
Audience Details | object |
Audience ID | text |
Audience Name | text |
Audience Type | text |
Audience Sub Type | text |
Status Message | text |
Error Message | text |
Available | boolean |
Expiring Soon | boolean |
Expires At | text |
Created At | text |
Modification History | array |
Action | text |
Result | text |
Operator | text |
Message | text |
Time | text |
Output fields[3]
| Field | Type |
|---|---|
Advertiser ID | text |
Advertiser Name | text |
Input fields[3]
| Field | Type |
|---|---|
Business Center | choice |
Limit | number |
Output fields[3]
| Field | Type |
|---|---|
Business Center | object |
Business Center ID | text |
Name | text |
Company Name | text |
Business Verification Status | text |
Currency | text |
Registration Code | text |
Status | text |
Time Zone | text |
Business Center Type | text |
Your Role | text |
Advanced Role | object |
Finance Role | text |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Limit | number |
Fields | array |
Filter | object |
Campaign IDs | array |
Campaign Name | text |
Automation Type | choice |
Advertising Objective | choice |
Primary Status | choice |
Secondary Status | text |
Campaign Origins | choice |
Sales Destination | choice |
Buying Types | choice |
Smart Performance Campaign Only | boolean |
Output fields[3]
| Field | Type |
|---|---|
Advertiser ID | text |
Campaign ID | text |
Campaign Name | text |
Created At | text |
Modified At | text |
Advertising Objective | text |
Campaign Type | text |
Automation Type | text |
15other output fields
Input fields[3]
| Field | Type |
|---|---|
Business CenterRequired | choice |
Limit | number |
Output fields[3]
| Field | Type |
|---|---|
Catalog ID | text |
Catalog Name | text |
Catalog Type | text |
Ad Creation Eligible | text |
Created At | text |
Updated At | text |
Business Center | object |
Business Center ID | text |
Business Center Name | text |
Profile Image URL | text |
Catalog Configuration | object |
Region Code | text |
Currency | text |
Channel | text |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Search FieldRequired | choice |
Search ValueRequired | text |
Start TimeRequired | date |
End TimeRequired | date |
Comment Type | text |
Comment Status | text |
Sort By | choice |
2other input fields
Output fields[3]
| Field | Type |
|---|---|
Comment ID | text |
Comment Text | text |
Comment Type | text |
Comment Status | text |
Likes | number |
Replies | number |
Original Comment ID | text |
Replied-To Comment ID | text |
22other output fields
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
AdRequired | choice |
FilterRequired | object |
Start DateRequired | date |
End DateRequired | date |
Limit | number |
Output fields[3]
| Field | Type |
|---|---|
Ad Group ID | text |
Ad ID | text |
Date | text |
Metrics | object |
Fatigue Detected | boolean |
Fatigue Index | number |
Daily New Users | number |
Daily New User Ratio | number |
Spend | number |
Cost Per Conversion | number |
Cost Per Conversion (SKAN) | number |
Input fields[3]
| Field | Type |
|---|---|
Business CenterRequired | choice |
Output fields[3]
| Field | Type |
|---|---|
Feed ID | text |
Feed Name | text |
Schedule Status | text |
Last Update | object |
Data Feed URL | text |
Update Mode | text |
Time Zone | text |
Interval Type | text |
Interval Count | number |
Day of Month | number |
Hour | number |
Minute | number |
Next Update At | text |
Number of Products | number |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
FilterRequired | object |
Campaign TypesRequired | choice |
TikTok Shops | choice |
Campaign IDs | choice |
Campaign Name | text |
Primary Status | choice |
Created After | date |
Created Before | date |
Limit | number |
Fields | array |
Output fields[3]
| Field | Type |
|---|---|
Advertiser ID | text |
Campaign ID | text |
Campaign Name | text |
Status | text |
Created At | text |
Modified At | text |
Advertising Objective | text |
Secondary Status | text |
1other output field
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Post Authorization CodeRequired | text |
Output fields[3]
| Field | Type |
|---|---|
Authorization Info | object |
Authorization Status | text |
Authorization Starts At | text |
Authorization Ends At | text |
Invited At | text |
Post Info | object |
Post Authorization Code | text |
Post ID | text |
Post Type | text |
Post Caption | text |
Post Status | text |
TikTok Account Info | object |
TikTok Display Name | text |
Identity ID | text |
Identity Type | text |
Video Info | object |
Video ID | text |
Width (px) | number |
Height (px) | number |
Duration (seconds) | number |
Cover Image URL (1 hour) | text |
Preview URL (1 hour) | text |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
IdentityRequired | choice |
Identity TypeRequired | choice |
Identity's Business Center ID | text |
Post Type | choice |
Search Text or Post ID | text |
Limit | number |
Output fields[3]
| Field | Type |
|---|---|
Post Authorization Code | text |
Post ID | text |
Post Type | text |
Post Caption | text |
Post Status | text |
Stitched-from Post ID | text |
Duet-of Post ID | text |
Nested Duet/Stitch | boolean |
3other output fields
Input fields[3]
| Field | Type |
|---|---|
Business CenterRequired | choice |
Limit | number |
Product IDs | array |
SKU IDs | array |
Short Drama Series IDs | array |
Product Set IDs | array |
Product Availability | choice |
Order | object |
Order By | choice |
Custom Order | array |
1other input field
Output fields[3]
| Field | Type |
|---|---|
Product ID | text |
SKU ID | text |
Audit | object |
Audit Status | text |
Available for Ad Creation | boolean |
Ad Creation Eligible | text |
Active Status | text |
Title | text |
Description | text |
9other output fields
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Limit | number |
Post Types | choice |
Search Text or Post ID | text |
Output fields[3]
| Field | Type |
|---|---|
TikTok Account Info | object |
TikTok Display Name | text |
Identity ID | text |
Identity Type | text |
Post Info | object |
Post Authorization Code | text |
Post ID | text |
Post Type | text |
Post Caption | text |
Post Status | text |
Carousel Info | object |
Anchors | array |
Authorization Info | object |
Authorization Status | text |
Authorization Starts At | text |
Authorization Ends At | text |
Invited At | text |
Video Info | object |
Bit Rate | number |
Duration (seconds) | number |
File Size (bytes) | number |
Height (px) | number |
Width (px) | number |
Cover Image URL | text |
Preview URL | text |
Signature | text |
Input fields[3]
| Field | Type |
|---|---|
Business CenterRequired | choice |
Limit | number |
Extra Fields | choice |
Filter | object |
Keyword | text |
Ad Account Status | choice |
Payment Portfolio ID | text |
Output fields[3]
| Field | Type |
|---|---|
Advertiser ID | text |
Advertiser Name | text |
Display Status | text |
Account Type | text |
Time Zone | text |
Currency | text |
Account Age (Days) | number |
Balance Low | boolean |
18other output fields
Input fields[3]
| Field | Type |
|---|---|
Business CenterRequired | choice |
Invoice TypesRequired | choice |
Limit | number |
Invoice ID | text |
Invoice Title | text |
Payment Status | choice |
Issued After (UTC) | date |
Issued Before (UTC) | date |
Output fields[3]
| Field | Type |
|---|---|
Invoice ID | text |
Serial Number | text |
Contract Subject ID | number |
Issue Date | text |
Currency | text |
Approval Status | text |
Due Date | text |
Invoice Type | text |
15other output fields
Input fields[3]
| Field | Type |
|---|---|
Business CenterRequired | choice |
Product Handling Log IDRequired | text |
Language | choice |
Output fields[3]
| Field | Type |
|---|---|
Product Handling Results | object |
Catalog ID | text |
Feed ID | text |
Items Added | number |
Items Updated | number |
Items Deleted | number |
Errors | number |
Warnings | number |
Processing Status | text |
Update Mode | text |
Started At | text |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Limit | number |
Fields | array |
Filter | object |
Campaign IDs | array |
Ad Group IDs | array |
Ad Group Name | text |
Primary Status | choice |
Secondary Status | text |
Advertising Objective | choice |
Sales Destination | choice |
Promotion Type | choice |
Optimization Goal | text |
Output fields[3]
| Field | Type |
|---|---|
Advertiser ID | text |
Campaign ID | text |
Campaign Name | text |
Ad Group ID | text |
Ad Group Name | text |
Promotion Type | text |
Optimization Goal | text |
Bidding Strategy | text |
14other output fields
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Limit | number |
Fields | array |
Filter | object |
Campaign IDs | array |
Ad Group IDs | array |
Ad IDs | array |
Primary Status | choice |
Secondary Status | text |
Advertising Objective | choice |
Sales Destination | choice |
Optimization Goal | text |
Created After | date |
Created Before | date |
Output fields[3]
| Field | Type |
|---|---|
Advertiser ID | text |
Campaign ID | text |
Campaign Name | text |
Ad Group ID | text |
Ad Group Name | text |
Ad ID | text |
Ad Name | text |
Operation Status | text |
3other output fields
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Limit | number |
Fields | array |
Filter | object |
Campaign IDs | array |
Campaign Name | text |
Search Ads Campaign Filter | choice |
Primary Status | choice |
Secondary Status | text |
Advertising Objective | choice |
Sales Destination | choice |
Created After | date |
Created Before | date |
Output fields[3]
| Field | Type |
|---|---|
Advertiser ID | text |
Campaign ID | text |
Campaign Name | text |
Created At | text |
Modified At | text |
Advertising Objective | text |
App Promotion Type | text |
Sales Destination | text |
14other output fields
Output fields[3]
| Field | Type |
|---|---|
Display Name | text |
Email | text |
User ID | text |
Created At | text |
Avatar URL | url |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Limit | number |
Filter | object |
Portfolio Types | choice |
Portfolio IDs | array |
Output fields[3]
| Field | Type |
|---|---|
Creative Portfolio ID | text |
Portfolio Type | text |
Portfolio Content | object |
Image ID | text |
Card Title | text |
Selling Points | array |
Call-to-action Text | text |
Interaction Prompt | text |
App ID | text |
Identity ID | text |
Identity Type | text |
Catalog ID | text |
TikTok Shop ID | text |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Event Source TypeRequired | choice |
Event Source IDRequired | text |
Limit | number |
Search | text |
Sort Field | choice |
Sort Direction | choice |
Output fields[3]
| Field | Type |
|---|---|
Custom Conversion ID | text |
Name | text |
Description | text |
Event Source Type | text |
Event Source ID | text |
Optimization Event | text |
Created At | text |
Updated At | text |
2other output fields
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Identity's Business Center ID | text |
Identity Type | choice |
Limit | number |
Filter | object |
Display Name | text |
Output fields[3]
| Field | Type |
|---|---|
Identity ID | text |
Identity Type | text |
Business Center ID | text |
TikTok Shop ID | text |
Ads-only Mode | boolean |
Government/Political/Party Account | boolean |
Profile Image URL (48 hours) | text |
Display Name | text |
11other output fields
Input fields[3]
| Field | Type |
|---|---|
Ad Account | choice |
Form Library | choice |
Status | choice |
Title | text |
Updated Between | object |
StartRequired | date |
EndRequired | date |
Page Type | choice |
Page Types | text |
Limit | number |
Output fields[3]
| Field | Type |
|---|---|
Page ID | text |
Status | text |
Title | text |
Preview URL | text |
Template ID | text |
Template Name | text |
Supported Objectives | array |
Thumbnail | text |
12other output fields
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Limit | number |
Pixel Code | text |
Pixel ID | text |
Pixel Name | text |
Sort Order | choice |
Available for Catalog Only | boolean |
Output fields[3]
| Field | Type |
|---|---|
Pixel ID | text |
Pixel Code | text |
Pixel Name | text |
Pixel Category | text |
Pixel Script | text |
Setup Mode | text |
Created At | text |
Partner Name | text |
6other output fields
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Material TypeRequired | choice |
All Time | boolean |
Start Date | date |
End Date | date |
Limit | number |
Info Fields | array |
Metric Fields | array |
3other input fields
Output fields[3]
| Field | Type |
|---|---|
Material Info | object |
Material ID | text |
Material Name | text |
Video ID | text |
Image ID | text |
Created At | text |
Spark Ad Post IDs | array |
Country/Region Codes | array |
Video Source | text |
Placements | array |
Identity Kind | text |
Metrics | object |
Impressions | number |
Clicks | number |
CTR (%) | number |
Spend | number |
CPC | number |
Conversions | number |
Cost Per Conversion | number |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
TikTok ShopsRequired | choice |
Start DateRequired | date |
End DateRequired | date |
MetricsRequired | array |
Group ByRequired | choice |
Limit | number |
Filter | object |
Campaign Types | choice |
Campaign IDs | choice |
Campaign Name | text |
Campaign Statuses | choice |
Product SPU IDs | array |
Creative Delivery Statuses | choice |
Search | text |
Livestream Room IDs | array |
2other input fields
Output fields[3]
| Field | Type |
|---|---|
Dimensions | text |
Metrics | text |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
DimensionsRequired | array |
Start Date | date |
End Date | date |
Metrics | array |
Query Lifetime | boolean |
Filter | object |
Campaign IDs | array |
Ad Group IDs | array |
Ad IDs | array |
Main Creative Types | choice |
Main Creative IDs | array |
Ad Text Entity IDs | array |
Call-to-Action Entity IDs | array |
Interactive Add-on Entity IDs | array |
Sort Field | text |
2other input fields
Output fields[3]
| Field | Type |
|---|---|
Dimensions | object |
Advertiser ID | text |
Campaign ID | text |
Ad Group ID | text |
Ad ID | text |
Material ID | text |
Main Creative Type | text |
Metrics | object |
Ad Material ID | text |
Main Creative Name | text |
Ad Text | text |
Call to Action | text |
Primary Status | text |
Operation Status | text |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Limit | number |
Filter | object |
Image IDs | array |
Material IDs | array |
Height (px) | number |
Width (px) | number |
Aspect Ratios | array |
Displayable Only | boolean |
Output fields[3]
| Field | Type |
|---|---|
Image ID | text |
Material ID | text |
Usable In Carousel Ads | boolean |
Displayable | boolean |
Width (px) | number |
Height (px) | number |
Format | text |
Image URL (1 hour) | text |
6other output fields
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Advertising ObjectiveRequired | choice |
PlacementsRequired | choice |
Search TypeRequired | choice |
KeywordsRequired | array |
Promotion Type | choice |
Country/Region Codes | array |
Location Types | choice |
3other input fields
Output fields[3]
| Field | Type |
|---|---|
Matched Tags | array |
Matched Keyword | text |
Targeting Type | text |
Name | text |
Status | object |
Location | object |
Parent Locations | array |
Targeting Type | text |
Name | text |
Status | object |
Location | object |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Limit | number |
Sort By | choice |
Filter | object |
Video IDs | array |
Material IDs | array |
Video Name | text |
Video Sources | choice |
Output fields[3]
| Field | Type |
|---|---|
Video ID | text |
Material ID | text |
Displayable | boolean |
Width (px) | number |
Height (px) | number |
Cover Image URL (6 hours) | text |
Bit Rate (bps) | number |
Format | text |
12other output fields
Input fields[3]
| Field | Type |
|---|---|
Ad AccountsRequired | choice |
ID TypesRequired | choice |
Batch DataRequired | array |
EntriesRequired | array |
Action | choice |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Ad GroupRequired | choice |
Ad | choice |
Appeal Reason | text |
Attachments | array |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
AudienceRequired | choice |
Ad GroupsRequired | choice |
Action ModeRequired | choice |
Usage Mode | choice |
Input fields[3]
| Field | Type |
|---|---|
Business CenterRequired | choice |
MemberRequired | choice |
Asset TypeRequired | choice |
AssetRequired | choice |
Ad Account Role | choice |
Catalog Role | choice |
Form Library Role | choice |
TikTok Account Roles | choice |
2other input fields
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Advertising ObjectiveRequired | choice |
Campaign NameRequired | text |
App Promotion Type | choice |
Sales Destination | choice |
App | choice |
Product Source | choice |
Budget Mode | choice |
13other input fields
Output fields[3]
| Field | Type |
|---|---|
Advertiser ID | text |
Campaign ID | text |
Campaign Name | text |
Created At | text |
Modified At | text |
Advertising Objective | text |
Campaign Type | text |
Status | text |
9other output fields
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Portfolio TypeRequired | choice |
Portfolio Content | object |
Call-to-action Text | text |
Smart CTA Text IDs | array |
Card Type | choice |
Gesture Type | choice |
Image ID | text |
Pop-up Image ID | text |
Card Title | text |
Selling Points | array |
Interaction Prompt | text |
Show Time (seconds) | number |
Output fields[3]
| Field | Type |
|---|---|
Creative Portfolio ID | text |
Input fields[3]
| Field | Type |
|---|---|
Business CenterRequired | choice |
Feed NameRequired | text |
Update ModeRequired | choice |
Schedule | object |
Source | object |
Interval Type | choice |
Interval Count | number |
Time Zone | text |
Day of Month | number |
Hour | number |
Minute | number |
Output fields[3]
| Field | Type |
|---|---|
Feed ID | text |
Feed Name | text |
Schedule Status | text |
Last Update | object |
Data Feed URL | text |
Update Mode | text |
Time Zone | text |
Interval Type | text |
Interval Count | number |
Day of Month | number |
Hour | number |
Minute | number |
Next Update At | text |
Number of Products | number |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
TikTok ShopRequired | choice |
Shop's Business CenterRequired | choice |
Campaign TypeRequired | choice |
Optimization GoalRequired | choice |
Bid StrategyRequired | choice |
Daily BudgetRequired | number |
Schedule TypeRequired | choice |
13other input fields
Output fields[3]
| Field | Type |
|---|---|
Advertiser ID | text |
Status | text |
Campaign ID | text |
Campaign Name | text |
TikTok Shop ID | text |
Store Authorized BC ID | text |
Campaign Type | text |
Product Selection | text |
18other output fields
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Audience NameRequired | text |
Lookalike SpecRequired | object |
Source AudienceRequired | choice |
Include Source AudienceRequired | boolean |
Device OSRequired | choice |
PlacementsRequired | choice |
Location IDsRequired | array |
SizeRequired | choice |
Output fields[3]
| Field | Type |
|---|---|
Custom Audience ID | text |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
CampaignRequired | choice |
Ad Group NameRequired | text |
Optimization GoalRequired | text |
Billing EventRequired | choice |
Budget ModeRequired | choice |
BudgetRequired | number |
Schedule TypeRequired | choice |
83other input fields
Output fields[3]
| Field | Type |
|---|---|
Advertiser ID | text |
Campaign ID | text |
Campaign Name | text |
Ad Group ID | text |
Ad Group Name | text |
Created At | text |
Modified At | text |
Optimization Goal | text |
15other output fields
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Audience NameRequired | text |
Audience TypeRequired | choice |
RuleRequired | object |
Inclusion RulesRequired | object |
Exclusion Rules | object |
Identity | choice |
Identity Type | choice |
Business Center | choice |
Audience Sub Type | choice |
2other input fields
Output fields[3]
| Field | Type |
|---|---|
Custom Audience ID | text |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Ad GroupRequired | choice |
Ad Name | text |
Status | choice |
Creatives | array |
Ad Texts | array |
Auto Messages | array |
Calls to Action | array |
1other input field
Output fields[3]
| Field | Type |
|---|---|
Advertiser ID | text |
Ad Group ID | text |
Ad ID | text |
Ad Name | text |
Operation Status | text |
Created At | text |
Ad Texts | array |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
CampaignRequired | choice |
Request IDRequired | text |
Ad Group NameRequired | text |
Promotion Type (Optimization Location)Required | choice |
Optimization GoalRequired | text |
Bidding StrategyRequired | choice |
Billing EventRequired | choice |
52other input fields
Output fields[3]
| Field | Type |
|---|---|
Advertiser ID | text |
Campaign ID | text |
Campaign Name | text |
Ad Group ID | text |
Ad Group Name | text |
Created At | text |
Promotion Type | text |
Optimization Goal | text |
9other output fields
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Advertising ObjectiveRequired | choice |
Campaign NameRequired | text |
Request IDRequired | text |
App Promotion Type | choice |
Sales Destination | choice |
Catalog Type | choice |
App | choice |
5other input fields
Output fields[3]
| Field | Type |
|---|---|
Advertiser ID | text |
Campaign ID | text |
Campaign Name | text |
Created At | text |
Modified At | text |
Advertising Objective | text |
Campaign Type | text |
Operation Status | text |
6other output fields
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Blocked WordsRequired | array |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Object TypeRequired | choice |
Object IDsRequired | array |
Negative KeywordsRequired | array |
Replace Existing | boolean |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Ad GroupRequired | choice |
MediaRequired | array |
Ad Titles | array |
Call-to-actions | array |
Deeplinks | array |
Display Names | array |
Pages | array |
3other input fields
Output fields[3]
| Field | Type |
|---|---|
Advertiser ID | text |
Ad Group ID | text |
Media Info | array |
Ad Titles | array |
Call-to-actions | array |
Deeplinks | array |
Display Names | array |
Pages | array |
3other output fields
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
AdRequired | choice |
TikTok Video IDRequired | text |
Comment IDRequired | text |
Identity TypeRequired | choice |
IdentityRequired | choice |
Input fields[3]
| Field | Type |
|---|---|
Business CenterRequired | choice |
Member | choice |
User Email | text |
Input fields[3]
| Field | Type |
|---|---|
Test Lead IDRequired | text |
Ad Account | choice |
Form Library | choice |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
AudiencesRequired | choice |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Blocked WordsRequired | array |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Object TypeRequired | choice |
Object IDRequired | text |
Negative KeywordsRequired | choice |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Saved AudiencesRequired | choice |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Advertising ObjectiveRequired | choice |
Optimization GoalRequired | text |
Placement Type | choice |
Placements | choice |
App | choice |
Pixel | choice |
Promotion Type | text |
34other input fields
Output fields[3]
| Field | Type |
|---|---|
Audience Size Rating (1 Too Narrow - 4 Fairly Broad) | number |
Estimated Audience Size | object |
Lower End | number |
Upper End | number |
Purchase Intention Keyword IDs | array |
Input fields[3]
| Field | Type |
|---|---|
Business CenterRequired | choice |
EmailsRequired | array |
RoleRequired | choice |
Asset Type | choice |
Ad Accounts to Assign | choice |
Ad Account Role | choice |
Finance Role | choice |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
AdRequired | choice |
TikTok Video IDRequired | text |
Comment IDRequired | text |
Comment TypeRequired | choice |
Reply TextRequired | text |
Identity TypeRequired | choice |
IdentityRequired | choice |
Output fields[3]
| Field | Type |
|---|---|
Comment ID | text |
TikTok Video ID | text |
Reply Text | text |
Created At | text |
Replied-To Comment ID | text |
Input fields[3]
| Field | Type |
|---|---|
EventRequired | text |
Offline Event Set IDRequired | text |
Event ID | text |
ContextRequired | object |
UserRequired | object |
PropertiesRequired | object |
Order ID | text |
Shop ID | text |
Contents | array |
Currency | text |
Value | number |
Event Channel | choice |
TimestampRequired | date |
Input fields[3]
| Field | Type |
|---|---|
Event SourceRequired | choice |
Event Source IDRequired | text |
EventsRequired | array |
Input fields[3]
| Field | Type |
|---|---|
Pixel CodeRequired | text |
EventRequired | choice |
Event ID | text |
Timestamp | date |
ContextRequired | object |
Ad | object |
Page | object |
User | object |
IP Address | text |
User Agent | text |
Properties | object |
Content Type | choice |
Contents | array |
Currency | text |
Value | number |
Search Query | text |
Description | text |
Status | text |
Input fields[3]
| Field | Type |
|---|---|
Offline Event Set IDRequired | text |
EventsRequired | array |
Input fields[3]
| Field | Type |
|---|---|
Business CenterRequired | choice |
MemberRequired | choice |
Asset TypeRequired | choice |
AssetRequired | choice |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
CampaignRequired | choice |
Campaign Name | text |
Budget | number |
Special Ad Categories | choice |
PO Number | text |
Output fields[3]
| Field | Type |
|---|---|
Advertiser ID | text |
Campaign ID | text |
Campaign Name | text |
Created At | text |
Modified At | text |
Advertising Objective | text |
Status | text |
Budget Mode | text |
3other output fields
Input fields[3]
| Field | Type |
|---|---|
Business CenterRequired | choice |
Update ModeRequired | choice |
Schedule | object |
Source | object |
Interval Type | choice |
Interval Count | number |
Time Zone | text |
Day of Month | number |
Hour | number |
Minute | number |
Output fields[3]
| Field | Type |
|---|---|
Feed ID | text |
Feed Name | text |
Schedule Status | text |
Last Update | object |
Data Feed URL | text |
Update Mode | text |
Time Zone | text |
Interval Type | text |
Interval Count | number |
Day of Month | number |
Hour | number |
Minute | number |
Next Update At | text |
Number of Products | number |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
GMV Max CampaignRequired | choice |
Campaign Name | text |
ROI Target | number |
Daily Budget | number |
Product SPU IDs | array |
Schedule Type | choice |
End Time | date |
4other input fields
Output fields[3]
| Field | Type |
|---|---|
Advertiser ID | text |
Status | text |
Campaign ID | text |
Campaign Name | text |
TikTok Shop ID | text |
Store Authorized BC ID | text |
Campaign Type | text |
Product Selection | text |
18other output fields
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Lookalike AudiencesRequired | choice |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Ad GroupRequired | choice |
Ad Group Name | text |
Business Center (for the Catalog) | choice |
Deep Funnel Optimization | choice |
Deep Funnel Event Source | choice |
Deep Funnel Event Source ID | text |
Deep Funnel Optimization Event | text |
51other input fields
Output fields[3]
| Field | Type |
|---|---|
Advertiser ID | text |
Campaign ID | text |
Ad Group ID | text |
Ad Group Name | text |
Created At | text |
Modified At | text |
Budget | number |
Schedule Type | text |
9other output fields
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
AudienceRequired | choice |
New Audience Name | text |
File Paths | array |
File Modification Type | choice |
Audience Sub Type | choice |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Ad GroupRequired | choice |
Ad Group Name | text |
Bid Price | number |
Conversion Bid Price | number |
Target ROAS | number |
Automated Keywords | choice |
Search Keywords | array |
12other input fields
Output fields[3]
| Field | Type |
|---|---|
Advertiser ID | text |
Campaign ID | text |
Ad Group ID | text |
Ad Group Name | text |
Modified At | text |
Bidding Strategy | text |
Budget Mode | text |
Budget | number |
5other output fields
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Ad GroupRequired | choice |
Incremental Update | boolean |
Media | array |
Ad Titles | array |
Call-to-actions | array |
Deeplinks | array |
Display Names | array |
4other input fields
Output fields[3]
| Field | Type |
|---|---|
Advertiser ID | text |
Ad Group ID | text |
Media Info | array |
Ad Titles | array |
Call-to-actions | array |
Deeplinks | array |
Display Names | array |
Avatar Images | array |
4other output fields
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
New Lifetime Budgets | array |
Ad Group Budget | object |
New Daily Budgets | array |
Ad Group Budget | object |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
New Budgets | array |
Ad Group Budget | object |
Scheduled Budgets | array |
Ad Group Scheduled Budget | object |
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Upload MethodRequired | choice |
Image File | text |
Image MD5 Signature | text |
Image URL | text |
File ID | text |
Image Name | text |
Pre-review Info (JSON) | text |
Output fields[3]
| Field | Type |
|---|---|
Image ID | text |
Material ID | text |
Usable In Carousel Ads | boolean |
Displayable | boolean |
Width (px) | number |
Height (px) | number |
Format | text |
Image URL (1 hour) | text |
6other output fields
Input fields[3]
| Field | Type |
|---|---|
Ad AccountRequired | choice |
Upload MethodRequired | choice |
Video File | text |
Video MD5 Signature | text |
Video URL | text |
File ID | text |
Existing Video ID | text |
Video Name | text |
5other input fields
Output fields[3]
| Field | Type |
|---|---|
Video ID | text |
Material ID | text |
Displayable | boolean |
Width (px) | number |
Height (px) | number |
Cover Image URL (6 hours) | text |
Bit Rate (bps) | number |
Format | text |
14other output fields
Templates
Look for TikTok Ads templates in the WEXTL template library.
Browse templates →Explore alternative apps
- AWeber[2]Email marketing — lists, subscribers, campaigns, and broadcasts.
- BrandwatchConsumer intelligence and social listening platform for brand monitoring, insights, and research.
- beehiivPublish newsletters and manage subscribers in beehiiv.
- AkeneoProduct information management (PIM) for enriching and distributing catalog data.
- ActiveCampaignAutomate email marketing, CRM contacts, and customer journeys in ActiveCampaign.
References
- WEXTL® TikTok Ads Source Code connector implementation.
- Our users use cases and automations.
- Official API Documentation for TikTok Ads.
- WEXTL® visual workflow builder data.
Last updated: Sep 29, 2026 09:32