Send server-side events to TikTok Events API with pixel deduplication

Steps

1. Obtain an Events API access token from TikTok for Business and retrieve your Pixel ID from Events Manager.
2. Structure each event payload with the required fields: pixel_code, event, event_time (Unix timestamp), and a context object containing user data (email, phone, external_id — all SHA-256 hashed).
3. Set event_id to a stable, unique identifier for each event instance (e.g., order ID + event type); this value must match the event_id sent by the browser pixel for the same event so TikTok can deduplicate.
4. POST the event(s) to the Events API endpoint as a JSON array in the 'data' field; batching up to 1,000 events per request is supported.
5. Check the response for a 'code' of 0 (success); non-zero codes indicate validation errors on individual events, which are reported per-event in the 'errors' array.
6. Verify deduplication is working in Events Manager by comparing web event counts against server event counts over a 24-hour window; a near-1:1 ratio for the same event type signals correct dedup.