TikTok webhook not receiving leads: what to check

You connected a TikTok Ads Manager Instant Form to your system through a webhook, but leads are missing at the destination. Before rebuilding the integration, separate contacts collected before the connection from new ones and check that the form is subscribed. These are the first two checks in TikTok’s help for webhooks not receiving leads.

This route is for someone maintaining an already configured webhook integration with an Ads Manager Instant Form. It does not cover organic Business Account lead generation or the full diagnosis of HubSpot, LeadsBridge, or other connectors.

Confirm the form and its subscription

Identify the ad account and form you expect to receive data from. With the person who configured the webhook, check that the subscription to that form is enabled. Note when the integration for that form was completed; connecting another account or having a receiver available does not establish that this form is subscribed.

TikTok requires this check in its help, but does not provide a single screen-by-screen route there for every receiver. Inspect your integration’s configuration or ask its maintainer for that information before changing it.

Compare the lead’s time with the connection time

Retrieve leads from the same form in Leads Center or through a download. Compare when each lead was collected with when the integration was completed. Check that the times use the same time zone before ordering the events.

TikTok sends only leads collected after this integration was completed. Earlier leads do not sync automatically. In a fictional example with all times in UTC, the form is connected at 14:00. A lead collected at 13:40 missing from the webhook is consistent with that limit. A missing lead collected at 14:20 is a post-connection case you still need to investigate.

This comparison separates historical data from a possible new incident; it does not identify the cause of a missing delivery by itself.

Download the available history if you need it

You need Admin permission to download and manage leads. TikTok Ads Manager stores this data for 90 days. Its Instant Form lead access guide gives this route:

1. Sign in to TikTok Ads Manager and open Tools → Instant Page.
2. Hover over the correct Instant Form.
3. Select Download Lead Data and inspect the downloaded file.

The download includes leads from the form even if several ads used it, within the available history. Downloading the file does not enable retrospective webhook syncing. If you need to add it to the destination system, use that system’s import process and check for duplicates.

If a post-connection lead is still missing

Keep the account and form references, subscription time, lead collection time with its time zone, and the state observed at the receiver. Give these to the technical owner to compare both sides of the integration. When opening a case, avoid posting the lead’s name, email, or phone number in public messages.

If the lead appears in TikTok but not at the destination, you have a defined case to investigate; it still does not establish where delivery failed. If it is also missing in TikTok, check the form and selected period first. Do not recreate the form or delete its connection as a first attempt without retaining the state you need to diagnose it.