TikTok Events API

Datafly Signal delivers events to TikTok server-to-server using the TikTok Events API, replacing the client-side TikTok Pixel.

A newer TikTok Events API blueprint is also available with expanded preset coverage (B2B / SaaS in addition to Retail / Travel / Automotive). See TikTok Events API.

Prerequisites

Before configuring TikTok in Signal, you need:

A TikTok for Business / TikTok Ads Manager account with admin or Events Manager permissions
A TikTok Pixel (Web Event Source)
An Events API access token for that Pixel

Get your TikTok credentials

Sign in to TikTok Ads Manager.
Go to Assets → Events → Web Events and select your Pixel (or click Set up Web Events to create one).
The Pixel Code (e.g. CXXXXXXXXXXXXXXXXX) is shown on the Pixel overview page.
Open the Pixel’s Settings → Events API and click Generate access token. Copy the token immediately.

See TikTok’s Events API documentation for full details.

Configure the integration in Signal

In the Management UI, go to Integrations → Add Integration.
Select TikTok from the catalogue.
Give the integration a name (for your reference).
Choose a preset (Retail, Travel, or Automotive).
Fill in the required fields:

Field	Required	Description
`pixel_code`	Yes	TikTok Pixel Code from Ads Manager.
`access_token`	Yes	Events API access token.
`test_event_code`	No	Test event code for validation.

Choose which pipeline(s) this integration should run on.
Select consent categories (defaults to marketing).
Click Save.

Event mapping

Retail preset

Signal event	TikTok event
`page`	`Pageview`
`Products Searched`	`Search`
`Product Viewed`	`ViewContent`
`Product Added to Wishlist`	`AddToWishlist`
`Product Added`	`AddToCart`
`Checkout Started`	`InitiateCheckout`
`Payment Info Entered`	`AddPaymentInfo`
`Order Completed`	`Purchase`
`Lead Submitted`	`Lead`

Travel preset

Signal event	TikTok event
`page`	`Pageview`
`Destination Searched`	`Search`
`Listing Viewed`	`ViewContent`
`Listing Saved`	`AddToWishlist`
`Booking Started`	`InitiateCheckout`
`Payment Info Entered`	`AddPaymentInfo`
`Booking Completed`	`Purchase`
`Lead Submitted`	`Lead`

Automotive preset

Signal event	TikTok event
`page`	`Pageview`
`vehicle_searched`	`Search`
`vehicle_viewed` / `vehicle_compared`	`ViewContent`
`vehicle_saved`	`AddToWishlist`
`brochure_downloaded`	`Download`
`finance_quote_requested` / `trade_in_valued`	`SubmitForm`
`test_drive_booked`	`Lead`
`dealer_contacted`	`Contact`
`service_appointment_booked`	`Subscribe`

To customise, edit the integration’s Field Mappings in the Management UI.

Identity

Signal sends the following identity signals to TikTok, subject to consent and availability:

Capability	Field	Notes
Hashed email	`user.email`	SHA-256 (lowercase, trimmed)
Hashed phone	`user.phone_number`	SHA-256 (E.164)
External ID	`user.external_id`	`user_id` or anonymous identifier (hashed)
Click ID	`user.ttclid`	From the `ttclid` URL parameter
Browser ID	`user.ttp`	First-party TikTok browser ID, self-generated if absent
Client IP	`user.ip`	Forwarded from the original request
User-Agent	`user.user_agent`	Forwarded from the original request

Hashing is performed by Signal before delivery.

This integration is gated on the marketing canonical consent category. Events without marketing consent are not delivered.

Verify it’s working

Paste a test event code from TikTok Ads Manager into the integration’s test_event_code field.
In the Management UI, open Pipelines → your pipeline → Live Events and trigger a test event.
The event appears in Signal’s live feed and in TikTok’s Test event tab within seconds.
Clear the test_event_code once validated.

Troubleshooting

Events aren’t appearing in TikTok.

Confirm the integration is enabled on the pipeline.
Confirm marketing consent is granted.
Inspect the delivery response — code: 40001 / 40100 indicate auth issues (regenerate the token).

code: 40002. The pixel code is invalid — verify the value in TikTok Ads Manager.