Cherry Seed

What events can I send via TikTok Events API?

tiktok events-api completePayment woocommerce server-side pixel deduplication

Quick Answer

TikTok Events API supports every standard event the Pixel supports — ViewContent, AddToCart, InitiateCheckout, AddPaymentInfo, CompletePayment, PlaceAnOrder, Subscribe, Contact, SubmitForm, CompleteRegistration, Download, ClickButton, Search, and AddToWishlist — plus custom events with any name you define. The event structure is identical; only the delivery method differs. For WooCommerce stores, the critical ecommerce events are CompletePayment for purchases, AddToCart, InitiateCheckout, and ViewContent. Each event accepts parameters including price, quantity, currency, content_id, and content_name. When running both Pixel and Events API, a shared event_id per conversion lets TikTok deduplicate automatically.

Full Answer

TikTok organises events into two categories. Standard events have predefined names that TikTok uses for reporting, conversion optimisation, and audience building. Custom events use advertiser-defined names for actions specific to a business that fall outside the standard list. Both categories work identically across Pixel and Events API — the payload structure, parameter names, and accepted values are the same regardless of whether the event arrives via browser JavaScript or server-to-server API call.

The standard ecommerce events map directly to WooCommerce's purchase funnel. ViewContent fires on product pages. AddToCart captures the cart action. InitiateCheckout marks the start of checkout. AddPaymentInfo records payment method selection. CompletePayment — TikTok's equivalent of a purchase event — sends the final transaction with order value, currency in ISO 4217 format, and product details. Each event accepts content parameters including price, quantity, content_id, content_name, content_category, and a value field representing total order amount.

For lead generation and engagement, the API supports Contact, SubmitForm, Subscribe, CompleteRegistration, Download, ClickButton, and Search. Custom events extend this for any action the standard list does not cover.

The critical implementation detail for WooCommerce stores using both Pixel and Events API is deduplication. Both layers must send the same event_id for each conversion — typically the WooCommerce order ID for purchases. TikTok deduplicates matching event_ids within 48 hours.

Sources

Programmatic Access

GET https://seresa.io/wp-json/cherry-tree-by-seresa/v1/seeds/715

Cite This Answer

Cherry Tree by Seresa - https://seresa.io/seed/tiktok-tracking/tiktok-events-api-tiktok-api-events