Skip to main content
POST
/
trackEvent
curl --request POST \
  --url https://js.hs-scripts.com/trackEvent \
  --header 'Content-Type: application/javascript' \
  --data @- <<EOF
"_hsq.push(['trackEvent', { id: '000000001625', value: 100 }]);"
EOF
Track behavioral events in your HubSpot reports. Events can be tied to a contact record so that you can see if/when a contact triggered that event.
Note: Events will only be processed for accounts with Marketing Hub Enterprise.

​
Usage

​
Track by Event ID

var _hsq = (window._hsq = window._hsq || []);
_hsq.push([
  "trackEvent",
  {
    id: "000000001625",
    value: 100,
  },
]);

​
Track by Event Name

var _hsq = (window._hsq = window._hsq || []);
_hsq.push([
  "trackEvent",
  {
    id: "custom_event_name",
    property1: "value1",
    property2: "value2",
  },
]);

​
Event IDs vs Names

  • Event ID: Use numerical IDs for events created in HubSpot (Reports > Analytics Tools > Behavioral Events)
  • Event Name: Use string names to dynamically create new events. If an event with that name doesn’t exist, it will be created automatically
  • Events created in the HubSpot app cannot be triggered by name, only by ID
  • Events created dynamically by name can only be created once. If you delete an event that was created this way, a new event will not be created if you try to dynamically trigger an event with the same name

Body

application/javascript

Event tracking data

​
eventId

The ID or name of the event to track

​
properties
object

Additional event properties

Response

200

Event tracked successfully

Last modified on January 28, 2026