Simple CAPI
TikTok conversion flow

How does TikTok Events API work?

TikTok Events API keeps the ad visit connected to the final conversion, sends the completed event through a protected server, and pairs it with the browser Pixel event using the same event ID.

Updated July 2026 7 min read Practical setup guide
Quick answer

What to do

A visitor arrives from TikTok, the page keeps the available click and browser details, and the conversion script waits for the exact form or confirmation page. When the conversion happens, the Pixel and server send matching events to TikTok with one event ID.

The TikTok Events API flow

The useful work starts when the visitor lands on the page. TikTok click information, campaign parameters, and the TikTok browser cookie can help connect the later conversion to the original visit.

The script then waits for the exact Lead form submission or Schedule confirmation. It creates one event ID, fires the browser Pixel event, and sends the server copy through the protected connection.

  • Ad click reaches the landing page
  • Visit details stay connected
  • The real conversion happens
  • Pixel and server events share one ID
  • TikTok receives one connected conversion

What TikTok uses for matching

The event can include permitted customer information, the TikTok click ID, the TikTok browser cookie, source URL, user agent, event time, value, and currency.

Simple CAPI prepares the supported matching information and sends it with the conversion while keeping the Events API token outside the website script. It reads an actual amount from supported form or booking data, preserves a real zero, and omits value and currency when no amount is available.

  • TTCLID when available
  • _ttp browser value
  • Email and phone when collected
  • Event source URL and user agent
  • Event ID and time, plus actual value and currency when available

How TikTok event deduplication works

The browser Pixel and Events API are separate requests. The shared event ID tells TikTok that both requests describe the same lead or booking.

A stable event ID also keeps a retry from looking like a second conversion.

  • Use the same standard event
  • Use the same event ID
  • Generate the ID once
  • Reuse it for a retry
  • Test both sources in Events Manager
Before you publish

How TikTok conversion tracking connects

01Preserve the TikTok visit

02Wait for the exact conversion

03Create one event ID

04Fire the matching Pixel event

05Send the Events API copy

06Verify one connected event

Frequently asked questions

Common questions about this setup

How does TikTok Events API work with the Pixel?+

The Pixel sends the browser copy and Events API sends the server copy. A shared event name and event ID connect them.

What is TTCLID?+

TTCLID is a TikTok click identifier that can appear on the landing URL after a TikTok ad click.

What is _ttp?+

_ttp is a TikTok browser cookie value that can help connect website activity to the browser session.

How does TikTok prevent duplicate conversions?+

Matching browser and server events use the same standard event and event ID.

Can one script track both Lead and Schedule?+

Lead and Schedule are separate conversion moments, so each uses its own event-specific script.

Official references

Use these official references when checking the current TikTok setup and account screens.

Keep learning

Related conversion tracking guides

Simple CAPI workspace

Turn the answer into a working TikTok conversion.

Choose Lead or Schedule, paste one protected script on the intended page, and verify the real conversion.

Create your script