Passer au contenu principal
PUT
/
integrators
/
timeline
/
v3
/
{appId}
/
event-templates
/
{eventTemplateId}
/
tokens
/
{tokenName}
Mettre à jour un jeton de modèle
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",
  "type": "enumeration",
  "createdAt": "2020-02-12T20:58:26Z",
  "updatedAt": "2020-02-12T20:58:26Z",
  "label": "Pet Type",
  "options": [
    {
      "value": "dog",
      "label": "Dog"
    },
    {
      "value": "cat",
      "label": "Cat"
    },
    {
      "value": "bird",
      "label": "Bird"
    }
  ]
}
Produits pris en charge
Exige l'un des produits suivants ou un produit supérieur.
Marketing HubMarketing HubGratuit
Sales HubSales HubGratuit
Service HubService HubGratuit
Content HubContent HubStarter

Autorisations

​
hapikey
string
query
requis

Paramètres de chemin

​
appId
integer<int32>
requis

L'ID de l'application cible.

​
eventTemplateId
string
requis

L'ID du modèle d'événement.

​
tokenName
string
requis

Le nom du jeton.

Corps

application/json

The updated token definition.

State of the token definition for update requests.

​
label
string
requis

Utilisé pour la segmentation de listes et le reporting.

​
objectPropertyName
string

Le nom de la propriété d'objet du CRM. Cela remplira la propriété d'objet du CRM associée à l'événement. Avec suffisamment de ces éléments, vous pouvez construire entièrement des objets CRM via l'API de chronologie.

​
options
object[]

Si le type est enumeration, nous devrions avoir une liste d'options parmi lesquelles choisir.

Réponse

successful operation

State of the token definition.

​
label
string
requis

Utilisé pour la segmentation de listes et le reporting.

​
name
string
requis

Le nom du jeton référencé dans les modèles. Il doit être unique pour le modèle spécifique. Il ne peut contenir que des caractères alphanumériques, des points, des tirets ou des tirets bas (. - _).

​
type
enum<string>
requis

Le type de données du jeton. Vous pouvez actuellement choisir parmi [chaîne, nombre, date, énumération].

Options disponibles:
date,
enumeration,
number,
string
​
createdAt
string<date-time>

La date et l'heure de création du jeton de modèle d'événement, sous la forme d'un horodatage ISO 8601. Sera nul si le modèle a été créé avant le 18 février 2020.

​
objectPropertyName
string

Le nom de la propriété d'objet du CRM. Cela remplira la propriété d'objet du CRM associée à l'événement. Avec suffisamment de ces éléments, vous pouvez construire entièrement des objets CRM via l'API de chronologie.

​
options
object[]

Si le type est enumeration, nous devrions avoir une liste d'options parmi lesquelles choisir.

​
updatedAt
string<date-time>

La date et l'heure de la dernière mise à jour du jeton de modèle d'événement, sous la forme d'un horodatage ISO 8601. Sera nul si le modèle a été créé avant le 18 février 2020.

Last modified on January 23, 2026