Skip to main content
GET
/
v1
/
event
Events HTTP API
curl --request GET \
  --url https://track.hubspot.com/v1/event
"https://track.hubspot.com/v1/event?_n=000000001625&_a=62515&email=testingapis@hubspot.com"
If you have an EU portal you must use the tracking server track-eu1.hubspot.com.
All symbols in a contact’s email address must be encoded, except for the following:
  • @ symbol
  • hyphen -
  • underscore _
  • period .

​
Response details

If the request is successful, it will have a status code of 200 with no data in the body. The content-type will be image/gif, so it’s possible to use HTTP API urls with <img> tags, though we recommend using the JavaScript API on webpages when possible.

​
Example URL

https://track.hubspot.com/v1/event?_n=000000001625&_a=62515&email=testingapis@hubspot.com

Query Parameters

​
_a
string
required

Your HubSpot Hub ID. See this page for help finding your Hub ID.

​
_n
string
required

The ID or name of the event you want to trigger.

​
email
string<email>

Associates the event with a known HubSpot contact. If the contact doesn't yet exist in HubSpot, it will be created. All symbols in a contact's email address must be encoded, except for the @ symbol, hyphen (-), underscore (_), and period (.).

​
_m
number

Any numerical amount that you provide here will increment the contact's Revenue field within the Web Analytics History section.

​
id
string

Ties the event to a record based on an external ID (not the HubSpot contact's ID). Unlike email, including this id will not automatically create a contact record.

Response

Event triggered successfully. The content-type will be image/gif, so it's possible to use HTTP API urls with img tags.

The response is of type file.