TTriggerTikTok Lead GenReal-timeUpdated June 2026

How do I run a workflow on a new TikTok lead?

Short answer: Drop the "TikTok Lead Gen → New Lead" trigger on your workflow canvas, add filters if you want them, and publish. It fires within seconds of the event in TikTok Lead Gen, not on a polling schedule.

Use this trigger All 1 TikTok Lead Gen triggers

Anatomy

What this trigger looks like in a workflow.

Drop it on the canvas. Configure a couple of fields. Publish.

In the builder

TriggerT

New Lead

When the matching event happens

new tiktok leadwhen a new lead is submitted via tiktoknew leadwatch for new leadon new leadtiktok lead submission

What this trigger returns

for the curious

You don’t need to read this. Tiny Command auto-maps every field into the visual picker so downstream nodes can pull values by clicking. We show it here for power users who want to know what’s on the wire.

{
  "lead_id": "9988776655",
  "page_id": "778899",
  "submit_time": "2025-01-15 10:30:00",
  "advertiser_id": "7000123456789012345"
}

Output shape

Fields available to downstream nodes.

Every field below can be referenced by name in any action or filter that comes after this trigger.

Field	Type	Example
lead_id	string	"9988776655"
page_id	string	"778899"
submit_time	string	"2025-01-15 10:30:00"
advertiser_id	string	"7000123456789012345"

Pairs with

Drop these actions after New Lead.

Add Labels to Message

Gmail · Email

Add Reaction

Slack · Communication

Add Sheet Tab

Google Sheets · Spreadsheets & Databases

Create Company

HubSpot · CRM & Sales

FAQ

Questions about New Lead.

How does the New Lead trigger work in TikTok Lead Gen?

Fires when a new lead is submitted via a TikTok Instant Form. Use it to push leads into your CRM, fire a welcome email, or assign to an SDR within seconds (which dramatically improves contact rates).

Is the New Lead trigger real-time?

Yes. New Lead uses webhooks or push subscriptions, not polling. Your workflow fires within seconds of the event happening in TikTok Lead Gen.

What data does New Lead return?

The full event payload from TikTok Lead Gen. The output shape table on this page lists every field, its type, and an example value so you can map fields into downstream nodes.

Can I filter New Lead so only some events start a workflow?

Yes. Add a Filter node right after the trigger and match on any field, whether that's subject, sender, status, or anything else in the payload. Workflows only continue when the filter passes.

Do I need TikTok Lead Gen admin permissions to use New Lead?

For most TikTok Lead Gen accounts a standard user can authorize the trigger. Some TikTok Lead Gen plans require an admin to enable third-party webhooks. Check TikTok Lead Gen's docs if the trigger fails to register.