HUhubspot
Basic

Send a custom event occurrence

Changed on

Send data for a single custom event occurrence.

post/events/2026-09/send

Request

  • Base URL
    https://api.hubapi.com
  • URL
    https://api.hubapi.com/events/2026-09/send
  • Auth
    OAuth 2
    Authorization code: https://app.hubspot.com/oauth/authorize
    Token URL: https://api.hubapi.com/oauth/v1/token scopes: analytics.behavioral_events.send

Request body

emailstring

The visitor's email address. Used for associating the event data with a CRM record.

eventNamestring required

The event's fully qualified name. This value (formatted as pe{HubID}_{name}) can be retrieved through the event definitions API or in HubSpot's UI.

objectIdstring

The ID of the record for which the event occurred (e.g., contact ID or visitor ID).

occurredAtstring date-time

The time when this event occurred. If this isn't set, the current time will be used.

propertiesobject required

The event properties to update. Takes the format of key-value pairs (property internal name and property value). Learn more about HubSpot's default event properties.

utkstring

The visitor's usertoken. Used for associating the event data with a CRM record.

uuidstring

A unique identifier for the event occurrence. Must be unique within the event type. If not provided, HubSpot will generate a random UUID. When multiple events have the same ID within a year, the first will be accepted and all others will be rejected. Can be useful for matching data between HubSpot and other external systems.

Example request

{
  "occurredAt": "2026-01-20T21:14:16.512Z"
}

Response

No content

Changes