HubSpot Events HTTP API

Last updated October 11, 2018


Method Details

HTTP Methods:


Response Format:


Requires Authentication?


Rate Limited?






Trigger a custom HubSpot event using an HTTP GET call.

If you're using HubSpot Events on the Enterprise version of the HubSpot software, you can use this call to trigger any custom events that you define in HubSpot (under "Reports -> Events"). You can then use events that you trigger to create smart lists, score leads and email contacts.

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

Please note: Events will only be processed for accounts with the enterprise edition of Marketing Hub, Sales Hub, or Service Hub.

Required Parameters How to use Description
HubSpot Hub (portal) ID &_a=XXXXXX - Used in the request URL. Your HubSpot Hub ID. See this page for help finding your Hub ID.
Event ID &_n= - Used in the request URL The ID or name of the event you want to trigger. See here for more details.
Optional Parameters How to use Description
Contact Email Address & - Used in the request URL If you want to tie the event that you're triggering to a contact in HubSpot, use this parameter. If the contact doesn't yet exist in HubSpot, it will be created. If the contact does exist, the event will be attributed to the existing contact.
Contact Revenue &_m=20 - Used in the request URL You can use Events to keep track of the monetary value that a contact is worth to you. Any numerical amount that you provide here will increment the "Revenue" field within the Web Analytics History section this value.
Any Contact Property &{property}={value} - Used in the request URL You can also include any contact property with the Event that you are triggering. This will populate the corresponding contact property for the contact specified by the email parameter. Make sure that the parameter you use here is the same as the property name (not the label) in the Contacts Settings area of HubSpot. For example, if you have a property with the name favorite_color, you can populate that property using &favorite_color=orange
External id &id={value} - Used in the request URL Ties the event to a record based on your external id. Unlike email, including this id will not automatically create a contact record, so you would need to have some event associating the id with an email (either a previous HTTP Event call with both the id and email, or by using the id with the JavaScript API for a visitor that was associated with an email address) to have the event update a specific contact if you're only including the id parameter. Also note that this id is treated as a completely external id, so there will not be a way to look up a contact record using this id.