Skip to main content
POST
/
track
cURL
curl --request POST \
  --url https://api.unifyintent.com/analytics/v1/track \
  --header 'Content-Type: application/json' \
  --data '{
  "type": "track",
  "visitorId": "<string>",
  "sessionId": "<string>",
  "timestamp": "2023-11-07T05:31:56Z",
  "sentAt": "2023-11-07T05:31:56Z",
  "context": {
    "library": {
      "name": "<string>",
      "version": "<string>"
    },
    "ip": "127.0.0.1",
    "locale": "<string>",
    "userAgent": "<string>",
    "userAgentData": {
      "brands": [
        {
          "brand": "<string>",
          "version": "<string>"
        }
      ],
      "mobile": true,
      "platform": "<string>"
    },
    "utm": {
      "source": "<string>",
      "medium": "<string>",
      "campaign": "<string>",
      "term": "<string>",
      "content": "<string>"
    }
  },
  "name": "<string>",
  "properties": {
    "path": "<string>",
    "query": {},
    "referrer": "<string>",
    "title": "<string>",
    "url": "<string>"
  }
}'

Body

application/json

A track event represents a custom action or activity performed by a visitor.

​
type
enum<string>
required

The type of analytics event being sent.

Available options:
track
​
visitorId
string
required

Unique identifier for the visitor that triggered this event.

​
sessionId
string
required

Unique identifier for the session in which this event occurred.

​
timestamp
string<date-time>
required

Timestamp of the event (in UTC).

​
context
object
required

Contextual information about the client behind the event. Contextual client information attached to an analytics event.

​
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.

​
name
string

Name of the event that was tracked.

​
properties
object

Details about the event that was tracked. Details about an event included in a track request.

Response

The request has succeeded.

⌘I