1. Home
  2. /
  3. Resources
  4. /
  5. What is the TikTok Events API?
Glossary

What is the TikTok Events API?

Vanessa Moreno
Vanessa Moreno
Journify
May 25, 2026 4 min read
Share
What is the TikTok Events API?

The TikTok Events API is a server-side integration that sends conversion data directly from your server to TikTok, without relying on a browser pixel. It gives TikTok's algorithm accurate, complete purchase signals so it can optimize your campaigns against what actually happened, not what the pixel managed to capture.

What the TikTok Events API replaces

Before server-side integrations existed, advertisers relied entirely on TikTok's browser pixel: a snippet of JavaScript that fires when a user lands on a confirmation page. The pixel works by reading browser behavior, which means it is blocked by ad blockers, dropped by Safari's Intelligent Tracking Prevention, and lost whenever a user switches devices or browsers between clicking an ad and completing a purchase.

The result is a gap. TikTok sees fewer conversions than actually occurred, and its algorithm optimizes against an incomplete picture. Budgets shift toward audiences and creatives that look better in a degraded dataset, not ones that are actually driving revenue.

The TikTok Events API closes that gap. Because it sends data server-to-server, it is not affected by browser restrictions. A purchase that the pixel would have missed still reaches TikTok.

How the TikTok Events API works

When a customer completes a purchase on your store, your server captures the event details: the order value, the product, and the customer's hashed identifiers (email address or phone number). Those details are sent directly to TikTok via the Events API, where TikTok matches them against its own user data to confirm which ad interaction drove the conversion.

The matching process uses hashed first-party data. TikTok never receives raw personal information. The hash is a one-way cryptographic representation of the customer's email or phone, which TikTok compares against hashed identifiers in its own system. A match confirms attribution. No match means the event is still recorded but not tied to a specific user.

Most setups run the Events API alongside the pixel rather than replacing it. When both fire for the same event, TikTok's deduplication logic ensures the conversion is counted once. The pixel handles speed; the Events API handles completeness.

Why it matters for campaign performance

TikTok's ad algorithm is a learning system. It studies which users convert and adjusts targeting, bidding, and delivery based on that data. When the signal is incomplete, the algorithm learns from a distorted version of reality. ROAS becomes volatile, scaling gets harder, and cost per purchase drifts upward for reasons that have nothing to do with your creative or your offer.

A correctly implemented Events API raises your event match quality score, which is TikTok's measure of how well your conversion data maps to real TikTok users. Higher match quality means the algorithm has more to work with. That usually shows up as more stable ROAS and better performance at scale.

If you're seeing unexplained drops in TikTok ROAS, poor match quality is one of the first things to check. You can read more about how signal loss affects TikTok specifically in how signal loss affects Meta, TikTok, Snap, and Google differently.

TikTok Events API vs the TikTok pixel

The pixel and the Events API are not competing tools. They solve different parts of the same problem.

The pixel is fast and easy to deploy. It fires client-side, which means it captures events quickly and requires no server infrastructure. Its weakness is coverage: any browser restriction, ad blocker, or cross-device journey creates a gap.

The Events API is slower to implement but more reliable. Because it runs server-side, it is not affected by what happens in the browser. Its weakness is that it requires server access and a correct implementation to work properly. A misconfigured Events API can send duplicate events, malformed data, or low-quality hashes that TikTok cannot match.

Running both together, with proper deduplication, gives you the speed of the pixel and the coverage of the API. That is the setup TikTok recommends and the one that produces the highest event match quality scores.

How to check your TikTok Events API match quality

In TikTok Ads Manager, go to Assets, then Events, then the web events section. Each event will show an event match quality score between 0 and 10. A score above 7 indicates strong matching. Below 5 means TikTok is receiving events but cannot connect most of them to real users, which limits what the algorithm can learn.

The score is driven by how many identifiers you send per event. Email alone typically produces a score around 5 to 6. Adding a hashed phone number and the ttclid pushes it to 7 or above. If your score is low, the fix is almost always adding more identifiers to the server event payload, not changing anything in the campaign itself.

Vanessa Moreno
Vanessa Moreno
Journify

Vanessa Moreno is Head of Marketing at Journify, where she builds the category for ad signal infrastructure across the GCC and US markets. She writes about signal loss, conversion data, and why most performance problems start upstream from the campaign.

You might also find this useful

More from the Glossary series.