Send a test event to TikTok Events API
Enter your TikTok Pixel Code and Events API access token, choose events and send them to Events API v1.3. With a test event code from Events Manager the events show up in Test Events, and the response tells you at once whether TikTok accepted them.
1 239 events sent through the service
What does Way2 Pixel send to TikTok?
Way2 Pixel (Pixel Activator) posts a single batch to business-api.tiktok.com/open_api/v1.3/event/track/ with event_source set to web and event_source_id set to your Pixel Code. The token goes in the Access-Token header and is not kept on our server after the request.
TikTok answers HTTP 200 even for many rejected requests, so the tool counts a send as successful only when the body also contains code 0.
| Field | What the tool sends | Note |
|---|---|---|
event |
The event you picked, e.g. Purchase or SubmitForm | A custom name is passed through unchanged |
event_time |
Current Unix time in seconds | |
event_id |
{event}_{time}_{random} |
Generated fresh for each event |
user |
ip and user_agent of the browser that pressed Send |
No email, phone or ttclid |
page.url |
Your Event source URL | Omitted when the field is empty |
properties |
value: 1, currency: USD | Purchase, AddToCart, ViewContent, StartTrial |
test_event_code |
Top-level field next to data[] |
Only when you enter a code |
Supported events
AddPaymentInfoAddToCart$1AddToWishlistApplicationApprovalCompleteRegistrationContactCustomizeProductDownloadFindLocationInitiateCheckoutPurchase$1ScheduleSearchStartTrial$1SubmitApplicationSubmitFormSubscribeViewContent$1
Events marked $1 are sent with an amount of 1 USD. You can also add one custom event name: letters, digits and underscore, up to 50 characters.
How does the TikTok test event code work?
TikTok, like Meta, isolates tests with a code. In Events Manager open your pixel, switch to Test Events and copy the test event code; paste it into the Test event code field of the form.
Requests with the code are shown in Test Events for that pixel. If you leave the field empty, TikTok treats the events as live signals for the pixel, which is what you want only after the setup is confirmed.
How do I confirm TikTok received the events?
- Look for code 0 in the response body; any other code means TikTok rejected the batch even if the HTTP status is 200.
- In TikTok Ads Manager go to Tools > Events Manager and open the same pixel.
- With a test code, open Test Events; without one, check the pixel's activity overview.
- Make sure the event name, source and time match what you sent before connecting a real integration.
Where are the Pixel Code and access token?
In Tools > Events Manager select the web pixel and copy its Pixel Code (TikTok also calls it pixel_code or event_source_id). The Events API token is generated in the pixel's Settings, in the Events API section.
Step by step: find the TikTok Pixel Code and generate an Events API token
Typical TikTok responses and what they mean
| What you see | Likely cause | What to do |
|---|---|---|
| Message mentions the access token | Token is wrong, revoked or created for another pixel | Generate a fresh Events API token in this pixel's Settings |
Message mentions the pixel or event_source_id |
Pixel Code is mistyped or belongs to another account | Copy the 20-character code from Events Manager again |
| Rate or frequency limit message | Too many requests to TikTok in a short window | Pause for a minute before the next send |
| Accepted, but no events in Test Events | The test event code is missing or outdated | Copy the current code from the Test Events tab |
FAQ
Pixel ID, Pixel Code, pixel_code — which one do I need?
event_source_id.Which purchase event should I pick for TikTok?
Why do some TikTok events carry 1 USD?
Do I need a website URL?
page.url and still sends the event.Further reading
Official documentation
Updated: 2026-10-14