v2

latestOpenAPI 3.0.3Proprietary2026-07-263483431.1 MB

Storefront

Send a TikTok Events API event

Public storefront endpoint. Sends browser-collected conversion events through Scalev using the TikTok pixels configured on the store's hosted storefront analytics setup. The store path selects the storefront; do not send a custom domain to identify the store. A 204 means the payload was accepted for asynchronous delivery.

post/v3/stores/{store_id}/public/analytics/tiktok/events

Request body

event_source_urlstring uri required

Full storefront page URL for the event. The API strips query parameters before sending to TikTok.

referrer_urlstring uri nullable

Browser referrer URL. The API uses this with event_source_url to choose checkout versus home storefront analytics configuration.

Example request

{
  "events": [
    {
      "event": "AddToCart"
    }
  ]
}

Response

Success with no response body