Manage Ad Accounts & Profiles

Documentation Index

Fetch the complete documentation index at: https://theoptimizer.io/docs/llms.txt

Use this file to discover all available pages before exploring further.

Once your TikTok integration is connected, you can manage the individual ad accounts and authentication profiles associated with it from Integrations → TikTok.

---

​

Ad Accounts

Click on the TikTok integration to see the full list of advertiser accounts pulled from your connected TikTok login.

​

Enable and Disable Accounts

Each ad account has an ON/OFF toggle. Disabling an account stops TheOptimizer from syncing data and running automation rules for that account. All historical data is retained — you can re-enable it at any time and data will resume syncing. You can also disable multiple accounts at once using the bulk actions menu.

---

​

Archive Ad Accounts

Archiving is a stronger form of removal than disabling. When an ad account is archived it is completely hidden from the system — it no longer appears in dropdown selectors, filters, or the Campaign Creator, and TheOptimizer stops all processing for it: no data sync, no automation rules, no campaign or resource visibility. Use archiving when you want to permanently retire an ad account from your workflow without losing the ability to restore it later if needed. Archive a single account Hover over any ad account row in the list. Below the account name, two inline actions appear: Edit and Archive. Click Archive to archive that account immediately. Archive multiple accounts at once Select the checkboxes next to two or more ad accounts. A bulk action bar appears at the bottom of the screen showing options including Manage Tags, Manage Linked Trackers, Change Profile, and Archive. Click Archive to archive all selected accounts in one operation. View and unarchive archived accounts Archived accounts are hidden from the default view. To find them:

1. Click Filters at the top of the ad accounts list.
2. Select Archived from the filter menu.
3. Choose Archived (to see only archived accounts) or All (to see both active and archived).
4. Click Apply Filters.

Once the archived accounts are visible, select one or more using their checkboxes, then click Unarchive in the bottom action bar. The account is immediately restored — it reappears in all selectors and filters, and TheOptimizer resumes data syncing and rule execution for it.

---

​

Assign Ad Accounts to a Profile

Each ad account uses one profile — the TikTok login TheOptimizer uses to access it. Ad account-to-profile assignments are managed from the Profiles panel: click Manage Ad Accounts on any profile card to open an assignment dialog where you can add or remove accounts from that profile. The dialog shows two sections: accounts that the selected profile has access to but which are currently assigned to a different profile (available to reassign), and accounts already using this profile. Select the accounts you want to add and click Save. You can also reassign a single ad account directly from the ad accounts table — hover the row and click Edit to change its assigned profile without opening the profiles panel.

---

​

Add Tags

Ad accounts can be tagged with any labels you define — by client, brand, vertical, team, or any other convention. Tags appear as filters throughout TheOptimizer, making it easy to work with specific subsets of accounts. Some tags (timezone, currency) are applied automatically by TheOptimizer when the account is first synced. To add a tag: click on the ad account → Tags → Add Tag.

---

​

Customise Tracker Connections Per Account

By default, tracker connections are configured at the integration level and apply to all ad accounts. But you can override this at the individual account level:

• Link a different tracker — use a different tracking platform for this specific account.
• Pause the tracker connection — stop pulling tracker data for this account without affecting others.
• Change the tracking template — use a different template (macro mapping) for this account.

Access these settings from Linked Trackers on the individual ad account page.

---

​

Profiles

Profiles are the TikTok logins (OAuth tokens) that TheOptimizer uses to access your TikTok advertiser accounts. After connecting TikTok via OAuth, each authenticated login becomes a profile.

​

Add New Profiles

Go to Integrations → TikTok → Profiles and click Add Profile. Complete the OAuth flow with the additional TikTok login. Reasons to add multiple profiles:

• Team access — each team member manages their own set of accounts under their own login.
• Backup access — if a primary profile is restricted or the token becomes invalid, a backup profile can take over the affected accounts immediately.
• Multiple TikTok Business accounts — different business accounts have different admin logins.

​

Sync New Ad Accounts

When you add a new advertiser account to a TikTok login you’ve already connected, it won’t appear automatically. To pull in the new account:

1. Go to Integrations → TikTok → Profiles.
2. Find the profile that has access to the new account.
3. Click Sync (or Refresh Accounts).

This triggers a re-sync for that profile and pulls in any new accounts without requiring a full re-authorisation.

​

Re-authenticate a Profile

TikTok OAuth tokens expire or become invalid when you:

• Change your TikTok account password
• The ad network detects suspicious activity on your account
• Security settings change
• The token is manually revoked from TikTok’s security settings

When a token expires, TheOptimizer can no longer sync data or run automation for the accounts under that profile. To re-authenticate:

1. Go to Integrations → TikTok → Profiles.
2. Find the profile showing an error or “Re-authentication required” warning.
3. Click Re-authenticate and complete the OAuth flow again.

Re-authenticating refreshes the token without losing any account history, automation settings, or tags.