Skip to content

Manage custom events with HubSpot event health

Last updated: January 30, 2025

Available with any of the following subscriptions, except where noted:

Marketing Hub   Enterprise
Sales Hub   Enterprise
Service Hub   Enterprise
Operations Hub   Enterprise
Content Hub   Enterprise


  •  

Manage custom event usage and resolve errors with HubSpot event health. 

Review custom event usage limits

  • In your HubSpot account, navigate to Data Management > Custom Events.
  • Navigate to the Health tab.
  • In the This month vs last month chart, view the number of event completions that have been used. 
event-completions

 

  • Use the All custom events table to view a breakdown of all custom events.

View custom event delivery errors

  • In your HubSpot account, navigate to Data Management > Custom Events.
  • Navigate to the Health tab.
  • In the left panel, navigate to the Delivery errors page.
  • View a summary of events that have been delivered with and without errors. 
  • For events that have an error, hover over the error in the Error logs table and click View error details

    view-error-details
  • In the right panel, view the error details.

Add properties to a custom event

Properties may appear as an error in the Health tab if they were sent via the API without being created on a custom event initially. This can be resolved by adding the property data to the event.

  • In your HubSpot account, navigate to Data Management > Custom Events.
  • Navigate to the Health tab.
  • In the left panel, navigate to the Delivery errors page.
  • Hover over an event in the Error logs table, then click Actions > Add properties to event.
add-properties-to-event

 

  • Based on the most recent property values in your events, suggested properties will be generated.
  • Review the properties and configure the HubSpot property label and Field type. 
  • To create the property, select the checkbox next to the property. Then click Confirm.
checkbox-create-property

 

Was this article helpful?
This form is used for documentation feedback only. Learn how to get help with HubSpot.