---
title: "POST /track"
method: POST
path: "/track"
tags: ["Events"]
---

# POST /track

`POST /track`

Send a "track" event.

## Request body

- TrackEvent — A track event represents a custom action or activity performed by a visitor.
  - `type` 'track', required — The type of analytics event being sent.
  - `visitorId` string, required — Unique identifier for the visitor that triggered this event.
  - `sessionId` string — Unique identifier for the session in which this event occurred.
  - `timestamp` string, date-time, required — Timestamp of the event (in UTC).
  - `sentAt` string, date-time — Timestamp at which the request is sent (in UTC). Typically, this value is nearly identical to `timestamp`. However in some situations there is latency between when the event occurs and when it is sent to Unify.
  - `context` EventContext, required — Contextual client information attached to an analytics event.
    - `library` object — Name and version of the library used to send the event.
      - `name` string
      - `version` string
    - `ip` union — IP address for the client that triggered the event.
      - string, ipv4
      - string, ipv6
    - `locale` string — Locale string for the client that triggered the event.
    - `userAgent` string — User agent string for the device.
    - `userAgentData` object — User agent data for the device.
      - `brands` object[]
        - `brand` string
        - `version` string
      - `mobile` boolean
      - `platform` string
    - `utm` CampaignParams — UTM parameters for tracking marketing campaigns.
      - `source` string — Source of the campaign.
      - `medium` string — Medium of the campaign.
      - `campaign` string — Name of the campaign.
      - `term` string — Term of the campaign.
      - `content` string — Content of the campaign.
  - `name` string, required — Name of the event that was tracked.
  - `properties` TrackProperties — Details about an event included in a track request.
    - `path` string — Path of the page (equivalent to `location.pathname`).
    - `query` object — Query string parameters (equivalent to `location.search`).
    - `referrer` string — Referrer page's full URL (equivalent to `document.referrer`).
    - `title` string — Page title (equivalent to `document.title`).
    - `url` string — URL of the page (equivalent to `location.href`).

## Response `200`

The request has succeeded.

## Other responses

- `202` — The request has been accepted for processing, but processing has not yet completed.
- `401` — Access is unauthorized.

---

[API](https://skmtc.dev/unifygtm/apis/unify-analytics-api.md) · [All operations](https://skmtc.dev/unifygtm/apis/unify-analytics-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/unifygtm/unify-analytics-api/revisions/2f145e6f6d7e/schema)