> ## Documentation Index
> Fetch the complete documentation index at: https://docs.markifact.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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:

```plaintext theme={"dark"}
[Recurring Schedule] → [Select Accounts] → [Get Report A]
                                        → [Get Report B]
                                        → [Analyze Data]
```

Now you only have to define the account list once. Each report node can reference it via:

```plaintext theme={"dark"}
Insert Dynamic Data → Select Accounts → Accounts
```

***

## 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

<Accordion title="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.
</Accordion>

<Accordion title="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**
</Accordion>

<Accordion title="Why are some fields hidden or disabled?">
  Fields like **Accounts**, **Filters**, and **Limit** are shown conditionally based on your **Selection Mode**. Changing modes resets incompatible fields to avoid conflicts.
</Accordion>

<Accordion title="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)
</Accordion>

<Accordion title="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"
</Accordion>

<Accordion title="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).
</Accordion>

<Accordion title="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)
</Accordion>

<Accordion title="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
</Accordion>

<Accordion title="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
</Accordion>

<Accordion title="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
</Accordion>