Before you begin

  • Create the TikTok Instant Form with the fields your sales team needs.
  • Confirm the ad account user has permission to manage and download leads.
  • Choose a connected CRM, automation tool, or middleware bridge that can send new leads to the InstaChime capture API.
  • Keep TikTok lead IDs and form IDs in the payload so duplicate submissions can be handled cleanly.

TikTok setup

  • Open TikTok Ads Manager and create or edit a Lead Generation campaign.
  • Attach the Instant Form and confirm the form questions and privacy-policy link.
  • In Leads Center or the CRM connection area, configure your chosen bridge or automation destination.
  • Configure the bridge to POST each new lead to `https://instachime.com/api/webhooks/capture`.
  • Send the InstaChime shared secret as `x-instachime-secret` from the bridge.

Payload example

{
  "source": "tiktok_lead_generation",
  "tiktok_lead_id": "tt-lead-001",
  "form_id": "tt-form-123",
  "full_name": "Jordan Patel",
  "email": "jordan@example.com",
  "phone": "+15555550123",
  "campaign": "TikTok home services lead form"
}

Verify

  • Submit a controlled TikTok lead or use a test path from your connector.
  • Confirm the bridge sends name, email, phone, source, form ID, and campaign fields.
  • Confirm the lead appears in `/app` and includes the original TikTok identifiers in raw fields.
  • Confirm alert and destination deliveries in `/integrations`.
  • Confirm a repeated TikTok lead ID is deduped.

Exact TikTok setup path

  • Open TikTok Ads Manager or Business Suite for the account that owns the Lead Generation campaign.
  • Create a Lead Generation campaign and attach an Instant Form.
  • Add the privacy policy URL, contact fields, and qualifying questions.
  • Open the Leads Center or CRM connection area for the account.
  • Choose your delivery route: approved CRM connector, Zapier/Make bridge, custom middleware, or manual export bridge.
  • Configure the route to send each new lead to `https://instachime.com/api/webhooks/capture`.
  • Send the shared secret as `x-instachime-secret` from the connector or middleware.
  • Keep the TikTok lead ID, form ID, ad ID, campaign ID, and submit time in the payload.

If using manual export as a temporary bridge

  • Download leads from TikTok Leads Manager before the lead retention window expires.
  • Import the CSV into a bridge script or no-code tool that posts each row to InstaChime.
  • Use the TikTok row identifier or a generated stable hash as the source ID.
  • Map TikTok columns to `full_name`, `email`, `phone`, `source`, `campaign`, and `message`.
  • Mark imported rows with the import timestamp so they can be distinguished from live leads.

TikTok mapping checklist

  • Map name, email, and phone first because they drive routing, dedupe, and alerts.
  • Map lead form question answers into raw fields and include the most sales-relevant answer in `message`.
  • Map campaign and ad context if the connector exposes those fields.
  • Send city, region, country, or postal code if territory routing is used.
  • Send consent fields if the form captures SMS or marketing consent.

TikTok troubleshooting

  • If no lead arrives, confirm the connector is attached to the same ad account and form that is receiving submissions.
  • If contact data is incomplete, check the Instant Form question configuration and required fields.
  • If leads arrive late, review whether the selected connector is live or polling/export based.
  • If territory routing fails, confirm city/region/country fields are included in the payload.
  • If duplicates appear after CSV import and live sync, use the TikTok lead ID as the source ID in both paths.

Official references

These vendor-owned pages explain the controls and requirements referenced in this guide.