Select Accounts
Select TikTok Ads accounts to use in other nodes
The Select Accounts node lets you define which TikTok Ads accounts to use in downstream nodes. You can select them manually, fetch all available, or use filters. This is an AI-powered node that can understand natural language instructions.
This node simplifies workflows with multiple TikTok Ads steps by centralizing account selection.
When to Use It
Use this node when:
- You want to avoid selecting the same TikTok Ads accounts in every report node
- You’re building larger workflows and want to manage account selection dynamically
- You need to reuse a filtered group of accounts based on naming or ID
- Building an AI agent that needs to list accounts before running reports
Inputs
Field | Type | Required | Description |
---|---|---|---|
Selection Mode | Select dropdown | Yes | Choose how to define your accounts: manual, all, or filtered |
Accounts | Multi-select | Yes (manual) | Manually select TikTok Ads accounts to use in later nodes |
Filters | Text filter | Yes (if filter mode) | Filter accounts by name or ID using text conditions |
Limit | Number | No | Max number of accounts to return in filter or all mode |
Selection Modes
- Manual Selection: Pick specific accounts one by one
- Select All Available: Automatically includes all TikTok Ads accounts tied to the authenticated connection
- Filter by Name/ID: Define rules (e.g., “Name contains ‘brand’”) to select accounts dynamically
The Accounts, Filters, and Limit fields will appear or hide automatically based on your selection mode.
Output
The node returns the selected account IDs and account information under a data
key. You can reference this in any downstream TikTok Ads node.
Account Selection Output:
- Account IDs: Unique identifiers for selected accounts
- Account Names: Human-readable names for each account
- Account Status: Active/inactive status information
- Permissions: Available operations for each account
Credit Cost
- Cost per run: Free to use (0 credits)
Example Use Case
Let’s say you run daily reports for multiple TikTok Ads accounts:
Now you only have to define the account list once. Each report node can reference it via:
Configuration Tips
- Authentication: Ensure your TikTok Ads connection is properly configured and has necessary permissions
- Account Access: Verify you have access to all accounts you want to select
- Naming Conventions: Use consistent account naming for easier filtering
- Error Handling: Configure retry policies for reliable automation
- Testing: Use test mode to validate your configuration before going live
FAQs
Can I reuse this account selection across multiple report nodes?
Can I reuse this account selection across multiple report nodes?
Yes. That’s exactly the point. Once you configure this node, other TikTok Ads nodes like Get Report can use its output via dynamic inputs.
How do I reference this in another node?
How do I reference this in another node?
In any downstream TikTok Ads node, click the dynamic data button (+) next to the Accounts input, then choose: Select Accounts → Accounts
Why are some fields hidden or disabled?
Why are some fields hidden or disabled?
How many accounts can I select?
How many accounts can I select?
- In manual mode: no strict limit, but performance may decrease with many accounts
- In all or filter mode: up to the API limit (with an optional
limit
parameter)
Can I filter by both Account Name and ID?
Can I filter by both Account Name and ID?
Yes. In filter mode, use one or more conditions like:
- Name contains “store”
- ID equals “1234567890”
What if I don't want a limit on the number of accounts?
What if I don't want a limit on the number of accounts?
Just leave the Limit field blank. All matching accounts will be selected (up to the internal API limit).
Why am I getting 'No accounts found' errors?
Why am I getting 'No accounts found' errors?
This can happen when:
- Your filters are too restrictive
- You don’t have access to any TikTok Ads accounts
- Your connection needs to be refreshed
- The accounts are suspended or inactive
- You need a TikTok business account (personal accounts won’t work)
Why can't I see certain accounts?
Why can't I see certain accounts?
Account visibility depends on:
- Business Account Required: You need a TikTok business account, not a personal account
- Permissions: You need at least read access to the account
- Account status: Suspended accounts may not appear
- Connection scope: Ensure your TikTok Ads connection has proper scope
- Access Token: Make sure all desired accounts are checked during TikTok’s authentication flow
My previously connected accounts disappeared - what happened?
My previously connected accounts disappeared - what happened?
This can happen because:
- Single Access Token: TikTok only issues one access token per user/app
- Authentication Flow: When connecting a new account, you must ensure ALL desired accounts are checked in TikTok’s authentication dialog
- Deselected Accounts: If you deselect a previously connected account during authentication, it will stop working
- Solution: Reconnect and make sure all accounts you want access to are selected in the TikTok authentication window
I can't connect to TikTok - what should I check?
I can't connect to TikTok - what should I check?
Connection issues are often due to:
- Account Type: You need a TikTok business account to connect
- Login Credentials: Make sure you’re using the correct business account credentials
- Authentication: Follow the proper TikTok authentication flow
- Permissions: Ensure your account has the necessary permissions for advertising data