---
title: "Send a landing page TikTok Events API event"
method: POST
path: "/v3/pages/{page_unique_id}/analytics/tiktok/events"
tags: ["Landing Page Runtime"]
---

# Send a landing page TikTok Events API event

`POST /v3/pages/{page_unique_id}/analytics/tiktok/events`

## Request

- Base URL: `https://api.scalev.com`
- URL: `https://api.scalev.com/v3/pages/{page_unique_id}/analytics/tiktok/events`
- Auth: none required

Page-scoped public endpoint used by `Scalev.analytics.track("tiktok", payload)`. The page path and API key select the page analytics configuration.

## Request body

- StorefrontTiktokConversionEventRequest
  - `tracking_context` string: Configured page, storefront, or widget interaction context. When present, the server validates the selected event and asset against the stored configuration.
  - `tracking_trigger` string: Interaction key from the saved tracking configuration.
  - `tracking_asset_id` integer: Business-owned provider asset assigned to this context.
  - `tracking_token` string: Optional signed runtime capability for the published configuration and allowed context. Preserve the token supplied by the runtime.
  - `tracking_renderer` 'vue' | 'html': Actual renderer sending the configured interaction. Selects the stored server parameter variant; does not grant access to other events or assets. Older clients default to vue.
  - `event_source_url` string, uri, required: Full storefront page URL for the event. The API strips query parameters before sending to TikTok.
  - `referrer_url` string, uri, nullable: Browser referrer URL. The API uses this with `event_source_url` to choose checkout versus home storefront analytics configuration.
  - `user` StorefrontTiktokConversionUserData, required
    - `email` string, nullable
    - `phone` string, nullable
    - `external_id` string, nullable
    - `ttclid` string, nullable
    - `ttp` string, nullable
    - `user_agent` string, nullable: Defaults to the observed API request user agent when omitted.
    - `ip` string, nullable: Filled from the observed API request IP.
  - `events` StorefrontTiktokConversionEvent[], required
    - `event_id` string, required
    - `event` string, required
    - `parameters` object
  - `variants` StorefrontAnalyticsVariantItem[]
    - `variant_unique_id` string, required: Variant unique ID from the storefront product payload.
    - `quantity` integer, required
  - `bundle_price_options` StorefrontAnalyticsBundlePriceOptionItem[]
    - `bundle_price_option_unique_id` string, required: Bundle price option unique ID from the storefront bundle payload.
    - `quantity` integer, required

## Response `204`

Success with no response body

## Other responses

- `400`: Bad Request
- `404`: Not Found

## Changes

- **2026-11-03** `6b9152f04622`: 5 info
  - added the new optional request property `tracking_asset_id`
  - added the new optional request property `tracking_context`
  - added the new optional request property `tracking_renderer`
  - added the new optional request property `tracking_token`
  - …1 more
- **2026-10-26** `f96c47558bd4`: 2 info
  - api tag `Landing Page Runtime` added
  - api tag `HTML Mode Pages` removed

[Operation history](https://skmtc.dev/scalev/apis/nexus-commerce-api/changes/v3/pages/:page_unique_id/analytics/tiktok/events/post.md)

---

[API](https://skmtc.dev/scalev/apis/nexus-commerce-api.md) - [All operations](https://skmtc.dev/scalev/apis/nexus-commerce-api/llms.txt) - [OpenAPI document](https://skmtc.dev/scalev/apis/nexus-commerce-api/revisions/6b9152f04622?raw)