TikTok Lead Forms

Pull TikTok lead-generation form submissions with AI agents. Agents discover the lead-gen forms in an advertiser account, inspect each form's question schema before mapping fields, and retrieve leads by submission time window for fast routing to sales.

3 actions API key available

TikTok Lead Forms website ↗ Platform Documentation ↗ Capability data verified 2026-07-28

A 15-minute schedule fires to sweep for fresh submissions

List Lead Forms discovers the active lead-gen forms in the advertiser account

List Lead Data pulls submissions since the last sweep, using the submission time window

Each lead's answers are mapped to CRM fields using the schema from Get Lead Form

Leads with incomplete or malformed contact data are separated from the clean batch

Clean leads sync to the CRM and the sales channel gets pinged with the new names

A sales lead reviews the ambiguous submissions and decides which get a call anyway

What This Integration Enables

The economics of lead forms are brutal about time: a person who tapped through a TikTok ad and handed over their phone number is reachable for a short window, and the value decays from there. This connector is read-only and single-purpose by design. It gets submissions out of the TikTok advertiser account and into the systems where follow-up actually happens, fast, and it does it schema-first so the mapping survives form edits. - Discover every lead-gen form in the advertiser account's page library - Read a form's question and field schema before mapping a single lead - Pull submissions filtered by submission time window for reliable incremental syncs - Route leads to CRM, spreadsheet, or sales-engagement tooling within minutes of capture Access is gated on TikTok's side: the app needs the lead-gen permission and the advertiser must authorize lead access. FlowRunner's contribution is what happens after retrieval, including the [human-in-the-loop](/concepts/human-in-the-loop) step that keeps automated routing from becoming automated misjudgment.

Without FlowRunner

Leads age in the ads platform Submissions sit in TikTok until someone exports a CSV, and the follow-up happens days after the intent

Field mapping is guesswork Every form has its own question schema, and downstream mapping breaks silently when a form changes

Sales hears about campaigns late The team learns a form is converting when the weekly report lands, not when the leads arrive

With FlowRunner

Minutes-old leads reach the CRM Time-windowed sweeps pull new submissions on a schedule and route them while the interest is real

The schema drives the mapping Agents read each form's question definition first, so field mapping follows the form, not a hardcoded guess

Sales is pinged per batch New submissions announce themselves in the sales channel with names, answers, and the source form

Use Case Scenarios

Form to CRM in one sweep

Every 15 minutes, the agent calls List Lead Data for each active form with the window set since the last run, then upserts each submission into [HubSpot](/integrations/hubspot) with the source campaign attached. Duplicate submissions match on email or phone rather than creating a second contact. Sales sees a TikTok lead in the CRM while the prospect still remembers filling out the form.

Straight into the outreach cadence

For a high-intent form, retrieved leads flow into [Salesloft](/integrations/salesloft) as new people added directly to a cadence. Before the cadence assignment runs, the agent checks the form's schema via Get Lead Form and validates that the qualifying question was answered; submissions that skipped it go to a review queue instead of the sequence. Speed for the clear cases, judgment for the rest.

The lead log with an alert on top

Each pull appends to a tracking sheet in [Google Sheets](/integrations/google-sheets), one row per submission with form name, timestamps, and answers. A [Slack](/integrations/slack) message summarizes the batch: which form, how many, and any submissions the validation step flagged. When a form suddenly goes quiet, the same workflow notices the empty window and says so, which is how broken forms get caught in hours instead of at month-end.

Human-in-Loop Highlight

This connector cannot delete or spend anything: all three actions read. The stakes live one step downstream, in what the workflow does with a retrieved lead, because routing a real person's name and phone number into an outreach cadence is an action that reaches a customer and cannot be recalled once the first touch fires. So the gate sits at the routing decision. Submissions that pass validation flow automatically; the ones with a skipped qualifying question, a suspect phone format, or answers that contradict each other go to a sales lead with the form's schema and the raw answers side by side. The human decides whether that ambiguous submission is a bad lead or a good customer who fat-fingered a field, a distinction no mapping rule makes reliably.

Agent processes routinely

Detects exception requiring judgment

Clear match Continues automatically

Ambiguous Routes to human via preferred channel

Human decides

Agent resumes with decision

Agent Capabilities

3 actions

Lead Forms

List Lead Forms Lists the lead-generation forms in the advertiser account's page library with each form's page id, name, status, and timestamps, paginated. The discovery step that supplies page_id values to the other two actions.
Get Lead Form Retrieves the full definition of a single form by page id: name, status, the question and field schema, privacy policy, and custom fields. Metadata about the form itself, read before mapping so downstream fields follow the actual questions asked.

Lead Data

List Lead Data Retrieves the submissions collected by a form: each lead's id, form id, submission time, and answered field values, optionally filtered to a submission time window and paginated. The action that gets leads out of TikTok and into the follow-up path. Requires the app's lead-gen permission and the advertiser's authorization.

Frequently Asked Questions

What can FlowRunner do with TikTok Lead Forms?

FlowRunner agents can run List Lead Forms, Get Lead Form, and List Lead Data in TikTok Lead Forms.

Does connecting TikTok Lead Forms to FlowRunner require OAuth?

No. TikTok Lead Forms connects to FlowRunner with an API key, no OAuth flow required.

Can TikTok Lead Forms trigger a FlowRunner workflow automatically?

TikTok Lead Forms doesn't currently expose triggers in FlowRunner. It connects as an action step inside workflows started by another trigger.

Start building with TikTok Lead Forms

$100 in credits. No card required. Connect in minutes.

Start Building Free Talk to us