Saltar al contenido principal
GET
/
integrators
/
timeline
/
v3
/
events
/
{eventTemplateId}
/
{eventId}
Obtener una instancia de evento
curl --request GET \
  --url https://api.hubapi.com/integrators/timeline/v3/events/{eventTemplateId}/{eventId} \
  --header 'Authorization: Bearer <token>'
{
  "eventTemplateId": "<string>",
  "id": "<string>",
  "objectType": "<string>",
  "tokens": {},
  "createdAt": "2023-11-07T05:31:56Z",
  "customObjectTypeId": "<string>",
  "domain": "<string>",
  "email": "<string>",
  "extraData": {},
  "objectId": "<string>",
  "timelineIFrame": {
    "headerLabel": "<string>",
    "height": 123,
    "linkLabel": "<string>",
    "url": "<string>",
    "width": 123
  },
  "timestamp": "2023-11-07T05:31:56Z",
  "utk": "<string>"
}

Productos compatibles

Se requiere uno de los siguientes productos o productos de ediciones superiores.
Marketing HubMarketing Hub -Gratuito
Sales HubSales Hub -Gratuito
Service HubService Hub -Gratuito
Content HubContent Hub -Gratuito

Autorizaciones

​
Authorization
string
header
requerido

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

Parámetros de ruta

​
eventId
string
requerido

El ID del evento.

​
eventTemplateId
string
requerido

El ID de la plantilla de evento.

Respuesta

successful operation

​
eventTemplateId
string
requerido

El ID de la plantilla de evento.

​
id
string
requerido

Identificador del evento. Debe ser único para la aplicación y la plantilla del evento. Si utilizas el mismo ID para diferentes objetos del CRM, el último en ser procesado ganará y el primero no tendrá un registro. También puedes usar "{{uuid}}" en cualquier parte del ID para generar una cadena única, garantizando la unicidad.

​
objectType
string
requerido

El ObjectType asociado con el EventTemplate.

​
tokens
object
requerido

Una colección de claves de token y los valores asociados con los tokens de plantilla.

​
createdAt
string<date-time>

Sin usar.

​
customObjectTypeId
string
​
domain
string

El dominio del evento (con frecuencia asociado con utk).

​
email
string

La dirección de correo utilizada para eventos específicos del contacto. Se puede usar para identificar contactos existentes, crear nuevos contactos o cambiar el correo de un contacto existente (si se combina con "objectId").

​
extraData
object

Datos adicionales específicos del evento que pueden ser interpretados por el markdown de la plantilla.

​
objectId
string

El identificador del objeto de CRM. Es obligatorio para todos los eventos excepto para los contactos (donde se puede usar utk o correo).

​
timelineIFrame
object
​
timestamp
string<date-time>

La hora cuando ocurrió el evento. Si no se incluye, se usará la hora actual. Esto se utiliza para determinar dónde se muestra un evento en la cronología de un objeto del CRM.

​
utk
string

Usa el parámetro "utk" para asociar un evento con un contacto por "usertoken". Esto se recomienda si no conoces el correo de un usuario, pero tienes un token que identifica al usuario en tu cookie.

Last modified on March 19, 2026