Pular para o conteúdo principal
PUT
/
integrators
/
timeline
/
v3
/
{appId}
/
event-templates
/
{eventTemplateId}
/
tokens
/
{tokenName}
Atualizar um token de modelo
curl --request PUT \
  --url 'https://api.hubapi.com/integrators/timeline/v3/{appId}/event-templates/{eventTemplateId}/tokens/{tokenName}?hapikey=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "label": "petType edit",
  "options": [
    {
      "value": "dog",
      "label": "Dog"
    },
    {
      "value": "cat",
      "label": "Cat"
    },
    {
      "value": "bird",
      "label": "Bird"
    }
  ]
}
'
{
  "name": "petType",
  "label": "Pet Type",
  "type": "enumeration",
  "createdAt": "2020-02-12T20:58:26Z",
  "updatedAt": "2020-02-12T20:58:26Z",
  "objectPropertyName": "customPropertyPetType",
  "options": [
    {
      "value": "dog",
      "label": "Dog"
    },
    {
      "value": "cat",
      "label": "Cat"
    }
  ]
}
Produtos suportados
Requer um dos seguintes produtos ou superior.
Marketing HubMarketing HubGrátis
Sales HubSales HubGrátis
Service HubService HubGrátis
Content HubContent HubStarter

Authorizations

​
hapikey
string
query
required

Path Parameters

​
appId
integer<int32>
required

O ID do aplicativo de destino.

​
eventTemplateId
string
required

O ID do modelo do evento.

​
tokenName
string
required

O nome do token.

Body

application/json

The updated token definition.

State of the token definition for update requests.

​
label
string
required

Usado para segmentação de listas e relatórios.

​
objectPropertyName
string

O nome da propriedade do objeto do CRM. Isso irá preencher a propriedade do objeto do CRM associada ao evento. Com uma quantidade suficiente de nomes, você pode construir completamente objetos do CRM utilizando a API de linha do tempo.

​
options
object[]

Se o tipo for "enumeration", devemos ter uma lista de opções para escolher.

Response

successful operation

State of the token definition.

​
label
string
required

Usado para segmentação de listas e relatórios.

​
name
string
required

O nome do token referenciado nos modelos. Deve ser exclusivo para o modelo específico. Pode conter apenas caracteres alfanuméricos, pontos, traços ou sublinhados (. - _).

​
type
enum<string>
required

O tipo de dados do token. Atualmente, você pode escolher entre [string, número, data, enumeração].

Opções disponíveis:
date,
enumeration,
number,
string
​
createdAt
string<date-time>

A data e hora em que o Token do modelo de evento foi criado, como um registro de data e hora ISO 8601. Será nulo se o modelo foi criado antes de 18 de fevereiro de 2020.

​
objectPropertyName
string

O nome da propriedade do objeto do CRM. Isso irá preencher a propriedade do objeto do CRM associada ao evento. Com uma quantidade suficiente de nomes, você pode construir completamente objetos do CRM utilizando a API de linha do tempo.

​
options
object[]

Se o tipo for "enumeration", devemos ter uma lista de opções para escolher.

​
updatedAt
string<date-time>

A data e hora em que o Token do modelo de evento foi atualizado pela última vez, como um registro de data e hora ISO 8601. Será nulo se o modelo foi criado antes de 18 de fevereiro de 2020.

Last modified on October 8, 2025