Skip to main content
POST
/
events
/
v3
/
send
Enviar una culminación de evento personalizado
curl --request POST \
  --url https://api.hubapi.com/events/v3/send \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "occurredAt": "2023-11-07T05:31:56Z",
  "eventName": "pe123456_account_login",
  "utk": "<string>",
  "uuid": "<string>",
  "email": "mark.s@lumon.industries",
  "properties": "{\"hs_page_id\":\"1234567890\",\"hs_element_id\":\"login-button\",\"hs_page_title\":\"homepage\"}",
  "objectId": "089274502"
}'
This response has no body data.

Productos compatibles

Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing Hub -Enterprise
Sales HubSales Hub -Enterprise
Service HubService Hub -Enterprise
Content HubContent Hub -Enterprise
Esta API requiere uno de los siguientes ámbitos:
analytics.behavioral_events.send

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
eventName
string
required

El nombre interno del evento (pe<portalID>_eventName). Se puede recuperar a través de la API de definiciones de eventos o en la IU de HubSpot.

Example:

"pe123456_account_login"

​
occurredAt
string<date-time>

La hora cuando ocurrió este evento. Si esto no se establece, se utilizará la hora actual.

​
utk
string

Ficha de usuario del visitante. Se utiliza para asociar los datos del evento a un registro del CRM.

​
uuid
string

Incluye un identificador único universal para asignar un ID único a la finalización del evento. Puede ser útil para cotejar datos entre HubSpot y otros sistemas externos.

​
email
string

Dirección de correo electrónico del visitante. Se utiliza para asociar los datos del evento a un registro del CRM.

Example:

"mark.s@lumon.industries"

​
properties
object

Las propiedades del evento a actualizar. Toma el formato de pares clave-valor (nombre interno de la propiedad y valor de la propiedad). Más información sobre Propiedades de eventos predeterminados de HubSpot.

Example:

"{\"hs_page_id\":\"1234567890\",\"hs_element_id\":\"login-button\",\"hs_page_title\":\"homepage\"}"

​
objectId
string

El ID del objeto que completó el evento (por ejemplo, ID de contacto o ID de visitante).

Example:

"089274502"

⌘I