Passer au contenu principal
POST
/
events
/
v3
/
send
Send a custom event occurrence
curl --request POST \
  --url https://api.hubapi.com/events/v3/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "eventName": "<string>",
  "email": "<string>",
  "objectId": "<string>",
  "occurredAt": "2023-11-07T05:31:56Z",
  "properties": {},
  "utk": "<string>",
  "uuid": "<string>"
}
'
This response has no body data.

Produits pris en charge

Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing Hub -Entreprise
Sales HubSales Hub -Entreprise
Service HubService Hub -Entreprise
Content HubContent Hub -Entreprise

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.

​
email
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.

​
properties
object

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.

​
utk
string

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

​
uuid
string

Include a universally unique identifier to assign a unique ID to the event occurrence. Can be useful for matching data between HubSpot and other external systems.

Réponse

Last modified on January 26, 2026