How to create TikTok Lead Gen and Hubspot connection

This guide walks you through the complete process of connecting a TiktTok Lead Gen (Source) to HubSpot (Destination) using the sysConnector platform. Once configured, user responses collected via TiktTok Lead will sync automatically into HubSpot.

Step 1: Create a New Connection

1. Log in to the sysConnector.

2. Click Create Connection.

Step 2: Configure TikTok Lead as the Source

Select TikTok Lead Generation

1. Choose TikTok Lead Generation from the app list

2. Click Next

Connect to TikTok Lead Generation

If you want to connect a TikTok account, follow these steps:

1. Enter an account name (for identification)
   Example: Marketing Team, Client XYZ
   This helps you easily recognize the account later in sysConnector.

2. Click the button below to connect TikTok
   Connect to TikTok Lead Generation

3. Complete TikTok login (OAuth)
   You will be redirected to TikTok to authorize access.

4. Return to sysConnector
   Once approved, your account will appear in the list of connected accounts.

Use an Existing Account

If you already connected a TikTok account, you can use it instead of creating a new one.

1. Select one of your connected accounts
   Choose from the list of previously connected TikTok accounts:

   • TikTok Online Store Sales
     Connected on 2026-04-16T03:33:42.240138

2. Continue with the selected account
   Click Continue with selected account to proceed using this connection.

Step 3: Configure HubSpot as the Destination

• Select HubSpot as the Destination App.

1. Enter a Destination Account Name
   Example: HubSpot Marketing or HubSpot CRM Prod.

2. Enter required credentials:

   • Private App Access Token

3. Click Connect to HubSpot to verify access.

Step 4: Define Connection Settings

1. Connection Name
   Use a clear, descriptive name such as:
   TikTok Lead Gen May 2026

2. Project Selection
   Choose an existing Project (folder) or use Unassigned.

3. Sync Frequency
   Select Event Space to enable real-time syncing when a lead is submitted.

Step 5: Field Mapping and Data Transformation

This step defines exactly how data collected in WhatsApp Bot is translated, formatted, and delivered into HubSpot. Proper configuration here ensures clean data, accurate reporting, and successful automation.

5.1 Basic Field Mapping

This section establishes a direct relationship between WhatsApp Bot fields (source) and HubSpot fields (destination).

Process:

• For each data point, select the WhatsApp Bot field on the left.

• Map it to the corresponding HubSpot field on the right.

Example:

• WhatsApp Bot field Name → HubSpot field First Name

• WhatsApp Bot field Email → HubSpot Email

If a required HubSpot field is not mapped, records may fail to sync or be rejected.

5.2 Using Custom Text

The Custom Text feature allows you to send a fixed value that does not exist in the WhatsApp Bot itself.

Common Use Case:

• Create a field in HubSpot called Lead Source

• Use Custom Text to automatically populate it with WhatsApp Bot for every lead coming through this connection

This is especially useful for campaign tracking, reporting, and segmentation.

5.3 Custom Transformations (Merging and Formatting)

Custom transformations allow you to manipulate or enhance data before it reaches HubSpot, which is useful when the data structures between systems do not align perfectly.

Merge Fields

• You can select multiple WhatsApp Bot fields and combine them into a single HubSpot field.

• You may apply a divider (comma, dash, pipe, etc.) between values for readability.

Example:
If your WhatsApp Bot contains separate columns for First Name and Last Name, you can merge them into a single Full Name field in HubSpot (e.g., John Doe).

Prefix and Postfix

You can add text before (prefix) or after (postfix) a value.

Example:

• Prefix: TK-

• Result: TK-john.doe@email.co

This is useful for tagging, internal labeling, or adding context to incoming data.

5.4 Data Type Conversion

In some cases, WhatsApp Bot sends data in a format that does not match the required data type in HubSpot.

Example:

• WhatsApp Bot sends a value as Text

• HubSpot requires an Integer

How sysConnector Handles This:

• During testing, sysConnector automatically detects mismatched data types.

• Since HubSpot field types are fixed, you must adjust the Source Type in sysConnector to match the destination field.

This ensures records are accepted and processed correctly.

5.5 Mandatory Testing and Validation

Before a connection can be activated, mapping must be tested successfully.

Process:

1. Enter sample test data for every mapped field.

2. Click Test Mapping.

3. The system validates formatting (e.g., email fields must contain valid email formats).

4. After a successful test, log in to HubSpot and confirm the test record appears correctly.

Activation is blocked until testing passes.

Step 6: Testing and Activation

1. Enter sample test data and click Test Mapping.
   This step is mandatory before activation.

2. Log in to HubSpot and confirm the test data was received correctly.

3. Click Save and Activate to begin live syncing.

Managing Your Connection

Monitoring

Go to Reports to view:

• Successful lead transfers

• Failed sync attempts

• Logs from the last 24 hours to 30 days