TikTok Leads Integration is an enterprise advertising integration that synchronizes potential customer (lead) data collected through Instant Forms (Instant Pages) in TikTok ads directly into Supsis AI in real time, automatically creates contact cards, and immediately triggers automated workflows.
With this integration, the need to open Lead Center in TikTok Ads Manager, download CSV files manually, clean data in Excel, and copy it into CRM systems is completely eliminated. Users who submit a form are saved as contacts in Supsis within seconds, instantly enabling actions such as WhatsApp welcome messages, automatic representative assignment, or third-party CRM synchronization.
Critical Distinction: TikTok Leads vs. TikTok DM
| Feature / Dimension | TikTok DM Integration | TikTok Leads Integration |
|---|---|---|
| Primary Purpose | Two-way customer messaging (chat) | Lead generation and collection from ads |
| TikTok Service API | TikTok Business Messaging API | TikTok Marketing API |
| Menu Location | Integrations › Social Media group | Integrations › Advertising group (/integrations/tiktok-leads) |
| Plan and License | TikTok DM Package | TikTok Lead Package (/billing/plans/tiktok-lead) |
| Contact Platform Tag | TikTok |
TikTok Leads |
| Authorization (OAuth) | Messaging permissions (message.list.*) |
Ad account and lead retrieval permissions |
Important Reminder: Even if an active TikTok DM channel is already connected to your Supsis panel, a separate channel must be created with separate authorization for TikTok Leads. This is because TikTok manages messaging and advertising data via two completely independent APIs.
1- What is TikTok Leads and How Does It Work?
1.a – How TikTok Instant Forms Work
When you launch an advertising campaign on TikTok with the "Lead Generation" objective, users who click the Call-to-Action (CTA) on your video ad see a fast, native form that opens without leaving the TikTok app. TikTok refers to this as an Instant Form or Instant Page.
Every user who submits the form becomes a Lead (Potential Customer). In traditional workflows, accessing these leads requires: - An ad manager navigating to TikTok Ads Manager › Lead Center, - Manually downloading CSV files, - Distributing data to sales or support representatives.
This process can take hours or even days. Under the "Speed-to-Lead" principle of digital advertising, leads contacted within the first 5 minutes convert at dramatically higher rates than those contacted hours later.
1.b – End-to-End Architecture with Supsis
- Authorization: Connect your TikTok Advertiser account to Supsis via secure OAuth.
- Asset Discovery: Supsis automatically retrieves all authorized ad accounts and linked Instant Forms.
- Webhook & Lead Subscription: Supsis registers an automated lead subscription via the TikTok Marketing API.
- Historical Data Sync: As soon as the channel is connected, full synchronization of past leads starts in the background.
- Live Ingestion: When a new user submits an Instant Form, TikTok dispatches an instant webhook signal to Supsis; Supsis retrieves lead details, creates the contact, and triggers automations.
2- Inbound Lead Data Fields
For every lead transferred to Supsis, the following data layers are recorded:
| Data Layer | Fields and Description | Storage in Supsis |
|---|---|---|
| Contact Identity | First Name, Last Name, Email, Phone Number | Automatically mapped to standard Contact Card fields. WhatsApp, SMS, and Email automations use these directly. |
| Complete Form Responses | All custom, single-choice, and multiple-choice questions asked on the form with user answers. | Stored as structured question → answer pairs in the contact card and automation payload. |
| Advertising Attribution | Campaign Name & ID, Ad Group Name & ID, Ad Name & ID, Advertiser ID. | Saved in contact card details and event history. Identifies which ad creative generated the lead. |
| Form Identity | Form Name and Form ID. | Used for form-based segmentation and filtering. |
| Timestamp | Date and time the form was submitted on TikTok. | Contact creation and processing timestamp. |
Contact Status and Platform Filter
Contacts created via TikTok Leads are automatically marked with the "Contact" status and tagged as "Contacted". The platform is set to TikTok Leads, allowing you to filter contacts by platform to see only leads originating from TikTok ads.
3- Channel Details and Management Tabs
When a TikTok Leads channel is created (/integrations/tiktok-leads/{channelId}/detail), 6 core management tabs are available in the left menu:
3.a – Detail Tab
View and edit the channel name, review the unique Channel ID, creation date, and overall channel operational health.
3.b – Visibility Tab
Configure which departments, teams, or individual customer representatives can view and manage leads and notifications from this channel.
3.c – Ad Accounts Tab
Lists all TikTok Advertiser accounts connected to Supsis through OAuth authorization.
- Sync Button: Click "Sync" whenever a new ad account is added in TikTok Business Center or permissions are updated to refresh the account directory immediately.
3.d – Forms Tab
Lists all Instant Forms defined under your connected advertiser accounts.
- Table Columns: Form ID, Form Name, Connected Advertiser Account, Form Status, and Total Leads collected by that form.
- Sync Forms: Whenever a new Instant Form is published in TikTok Ads Manager, click this button so Supsis recognizes the form.
3.e – Leads Tab
The central management dashboard where all captured leads are displayed chronologically.
- Columns: Name, Email, Phone Number, Form Name, Campaign Name, and Creation Date.
- Filtering & Search: Filter by specific Instant Forms, or search by name and phone number.
- Manual Synchronization: Trigger manual sync if there is any suspicion of network delay or missing records.
- Create Test Lead Button: Generate simulated leads for testing.
3.f – Campaigns Tab
Displays live campaign data for the selected ad account directly from TikTok.
- Details: Campaign ID, Campaign Name, Advertising Objective (Lead Generation, etc.), and Delivery Status read directly from TikTok Marketing API.
4- Create Test Lead Feature
To verify that the integration and attached automations work smoothly before spending ad budget or launching live campaigns, use the Create Test Lead tool.
4.a – Test Lead Steps:
- Open the Leads tab and click Create Test Lead at the top right.
- In the modal, select the targeted Ad Account and the Form to test (or enter a Form ID).
- Click Create.
- Supsis invokes TikTok's sandbox testing environment to generate a synthetic lead; this lead is instantly recorded in Supsis Contacts and triggers the "When a TikTok lead is generated" automation event.
5- Synchronization Types and Operating Principles
To guarantee complete data integrity, Supsis TikTok Leads provides 4 synchronization mechanisms:
| Sync Mode | Operating Principle | When to Use |
|---|---|---|
| Live (Webhook) Sync | TikTok sends an instant HTTP POST notification when a user submits a form. | Standard daily real-time operation. |
| Initial Channel Full Sync | Runs automatically in the background when the channel is first connected. | Imports historical leads previously collected in the ad account. |
| Manual Full Sync | Triggered by clicking the sync button in the Leads tab. | Used in case of unexpected network latency or suspected missing data. |
| Form Synchronization | Triggered via "Sync Forms" in the Forms tab. | Needed when a new form is created in TikTok Ads Manager. |
Rate Limits and Security (Rate Limiting)
To avoid TikTok Marketing API throttling and protect account health, historical batch synchronizations run queued at 1 request per second. In large accounts with thousands of leads, sync may take several minutes. Concurrent sync jobs cannot be started simultaneously, and duplicate contact records will never be created even if a lead is retrieved more than once.
6- Automation Integration (tiktok.lead_generated)
TikTok Leads integrates fully with the "When a TikTok lead is generated" event trigger under the TikTok module in the Supsis Automation Engine.
6.a – Example Scenarios:
- WhatsApp / SMS Welcome Message: Send an instant WhatsApp message with an offer or catalog to the user who just submitted the form.
- Automatic Representative Assignment: Route the lead to a specialized sales rep based on form type and send an internal notification.
- CRM Synchronization: Automatically record lead data as a new contact or deal in HubSpot, Salesforce, Zoho, Pipedrive, or Monday CRM.
- Form-Based Segmentation: Route users from a "Real Estate Form" to the sales team, and users from a "Careers Form" to HR.
6.b – Data Fields Available in Automation:
All lead fields can be used as dynamic tags in automation blocks and condition logic:
* lead_id, form_id, form_name, advertiser_id,
* campaign_id, campaign_name, adgroup_id, adgroup_name, ad_id, ad_name,
* email, phone_number, full_name,
* All custom form question-and-answer keys.
7- Setup Steps (Step-by-Step Guide)
7.a – Step 1: Create Instant Form in TikTok Ads Manager
- Log in to TikTok Ads Manager.
- Go to Assets › Instant Form and build and publish your lead form.
- Set your campaign objective to Lead Generation and connect the form to your ad creative.
7.b – Step 2: Add Channel in Supsis Panel
- Open the Supsis Customer Panel and go to Integrations in the left menu.
- Under the Advertising group, click the TikTok Leads card (
/integrations/tiktok-leads). - Click the + Add Channel button at the top right.
- Review the prerequisites in the modal:
- Having a TikTok Advertiser account,
- Having a published Instant Form,
- Acknowledging that separate authorization is required independently of TikTok DM.
- Click Connect to TikTok.
7.c – Step 3: Grant TikTok OAuth Permissions
- Sign in through the official TikTok OAuth authorization window.
- Select your ad accounts and approve access permissions for Supsis AI.
- After approval, return to Supsis and click Create Channel.
7.d – Step 4: Verification and Going Live
- Verify that your account appears in the Ad Accounts tab of the channel details.
- Switch to Forms and click Sync Forms to import your Instant Forms.
- Test using Create Test Lead in the Leads tab and confirm the contact appears under Contacts.
- Set up your automation flow and launch your TikTok ad campaigns live.
8- Package and License Management
TikTok Leads integration operates under a dedicated plan license:
* Package Page: Billing → Packages → TikTok Lead (/billing/plans/tiktok-lead)
* Quota Logic: You can connect active TikTok Leads channels up to your purchased quota limit.
* When the quota is reached, the panel displays an upgrade prompt when attempting to add new channels.
9- Glossary of Terms
| Term | Description |
|---|---|
| Lead (Potential Customer) | An individual who expresses interest in your products or services by submitting their contact information. |
| Instant Form (Instant Page) | An in-app lead form that opens natively within the TikTok app without redirecting the user. |
| Lead Generation (Objective) | The advertising campaign objective in TikTok Ads Manager required for collecting leads via forms. |
| Advertiser (Ad Account) | The TikTok account where ad budgets, creatives, and campaigns are managed. |
| Lead Center | The native TikTok Ads Manager section where collected leads can be viewed and downloaded. |
| Marketing API | The official TikTok developer service used by the TikTok Leads integration. |
| Lead Subscription | The webhook subscription enabling TikTok to notify Supsis in real time upon new form submissions. |
| Test Lead | A simulated lead generated to verify the integration and automations without spending ad budget. |
10- Frequently Asked Questions and Troubleshooting
10.a – "I connected the channel, but no leads are appearing. Why?"
- Instant Form Check: Ensure you have an active Lead Generation campaign and linked Instant Form in TikTok Ads Manager. If ads are paused or not running, leads will not be generated.
- Form Sync: Make sure you clicked "Sync Forms" in the Forms tab.
- Account Permissions: The authorizing TikTok user must have administrator/operator permissions on the relevant ad account.
10.b – "We have a TikTok DM channel. Do we have to connect again for Leads?"
- Yes. TikTok DM uses the messaging service (Business Messaging API), while TikTok Leads uses the advertising service (Marketing API). TikTok permissions require separate authorization and channel configuration for each.
10.c – "Leads appear in Supsis a few minutes late. Is this normal?"
- In some cases, TikTok servers send the form notification but delay populating complete lead details via API for a few minutes. Supsis polls periodically in the background to ensure complete lead data is ingested.
10.d – "Who is responsible for Data Privacy (GDPR / KVKK)?"
- The advertising business is legally considered the Data Controller for personal data (name, phone, email) collected via TikTok Instant Forms. Adding a link to your approved Privacy Policy inside your Instant Form is required.