Pular para o conteúdo principal
POST
/
integrators
/
timeline
/
v3
/
events
Enviar dados do evento (único)
curl --request POST \
  --url https://api.hubapi.com/integrators/timeline/v3/events \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "eventTemplateId": "<string>",
  "id": "<string>",
  "tokens": {},
  "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>"
}
'
{
  "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>"
}

Produtos suportados

Requer um dos seguintes produtos ou superior.
Marketing HubMarketing Hub -Grátis
Sales HubSales Hub -Grátis
Service HubService Hub -Grátis
Content HubContent Hub -Grátis

Autorizações

​
Authorization
string
header
obrigatório

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

Corpo

application/json
​
eventTemplateId
string
obrigatório

O ID do modelo do evento.

​
id
string
obrigatório

Identificador do evento. É opcional e recomendamos que você não inclua um. Se você omitir este identificador, criaremos um para você. Você também pode usar "{{uuid}}" em qualquer lugar do ID para gerar uma string única, garantindo a exclusividade.

​
tokens
object
obrigatório

Uma coleção de chaves de token e valores associados aos tokens do modelo.

​
customObjectTypeId
string
​
domain
string

O domínio do evento (frequentemente pareado com o utk).

​
email
string

O endereço de e-mail usado para eventos específicos de contato. Pode ser usado para identificar contatos existentes, criar novos contatos ou alterar o e-mail de um contato existente (se estiver pareado com o "objectId").

​
extraData
object

Dados adicionais específicos do evento que podem ser interpretados pelo markdown do modelo.

​
objectId
string

O identificador do objeto do CRM. É necessário para todos os eventos, exceto contatos (nos quais o utk ou o e-mail podem ser usados).

​
timelineIFrame
object
​
timestamp
string<date-time>

A hora em que o evento ocorreu. Se não for transmitido, a hora atual será usada. É usado para determinar onde um evento é mostrado na linha do tempo de um objeto do CRM.

​
utk
string

Use o parâmetro "utk" para associar um evento com um contato pelo "usertoken". É recomendado fazer isso se você não souber o e-mail de um usuário, mas tiver um token de identificação do usuário em seus cookies.

Resposta

successful operation

​
eventTemplateId
string
obrigatório

O ID do modelo do evento.

​
id
string
obrigatório

Identificador do evento. Deve ser exclusivo para o aplicativo e modelo de evento. Se você usar o mesmo ID para diferentes objetos do CRM, o último a ser processado prevalecerá e o primeiro não terá um registro. Você também pode usar "{{uuid}}" em qualquer lugar no ID para gerar uma string única, garantindo a exclusividade.

​
objectType
string
obrigatório

O ObjectType associado a EventTemplate.

​
tokens
object
obrigatório

Uma coleção de chaves de token e valores associados aos tokens do modelo.

​
createdAt
string<date-time>

Não usado.

​
customObjectTypeId
string
​
domain
string

O domínio do evento (frequentemente pareado com o utk).

​
email
string

O endereço de e-mail usado para eventos específicos de contato. Pode ser usado para identificar contatos existentes, criar novos contatos ou alterar o e-mail de um contato existente (se estiver pareado com o "objectId").

​
extraData
object

Dados adicionais específicos do evento que podem ser interpretados pelo markdown do modelo.

​
objectId
string

O identificador do objeto do CRM. É necessário para todos os eventos, exceto contatos (nos quais o utk ou o e-mail podem ser usados).

​
timelineIFrame
object
​
timestamp
string<date-time>

A hora em que o evento ocorreu. Se não for transmitido, a hora atual será usada. É usado para determinar onde um evento é mostrado na linha do tempo de um objeto do CRM.

​
utk
string

Use o parâmetro "utk" para associar um evento com um contato pelo "usertoken". É recomendado fazer isso se você não souber o e-mail de um usuário, mas tiver um token de identificação do usuário em seus cookies.

Last modified on March 24, 2026