Send an event occurrence

curl --request POST \ --url https://api.hubapi.com/events/2026-03/send \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "eventName": "<string>", "properties": {}, "email": "<string>", "objectId": "<string>", "occurredAt": "2023-11-07T05:31:56Z", "utk": "<string>", "uuid": "<string>" } '

Supported products

Required Scopes

Autorisations

Authorization

string

header

requis

The access token received from the authorization server in the OAuth 2.0 flow.

Corps

application/json

eventName

string

requis

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.

properties

object

requis

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.

Show child attributes

string

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

objectId

string

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

occurredAt

string<date-time>

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

utk

string

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

uuid

string

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.

Autorisations

Corps

Réponse