Skip to main content
PUT
/
integrators
/
timeline
/
v3
/
{appId}
/
event-templates
/
{eventTemplateId}
Update an event template
curl --request PUT \
  --url https://api.hubapi.com/integrators/timeline/v3/{appId}/event-templates/{eventTemplateId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "<string>",
  "name": "<string>",
  "tokens": [
    {
      "label": "<string>",
      "name": "<string>",
      "options": [
        {
          "label": "<string>",
          "value": "<string>"
        }
      ],
      "createdAt": "2023-11-07T05:31:56Z",
      "objectPropertyName": "<string>",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "detailTemplate": "<string>",
  "headerTemplate": "<string>"
}
'
import requests

url = "https://api.hubapi.com/integrators/timeline/v3/{appId}/event-templates/{eventTemplateId}"

payload = {
    "id": "<string>",
    "name": "<string>",
    "tokens": [
        {
            "label": "<string>",
            "name": "<string>",
            "options": [
                {
                    "label": "<string>",
                    "value": "<string>"
                }
            ],
            "createdAt": "2023-11-07T05:31:56Z",
            "objectPropertyName": "<string>",
            "updatedAt": "2023-11-07T05:31:56Z"
        }
    ],
    "detailTemplate": "<string>",
    "headerTemplate": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)
const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    id: '<string>',
    name: '<string>',
    tokens: [
      {
        label: '<string>',
        name: '<string>',
        options: [{label: '<string>', value: '<string>'}],
        createdAt: '2023-11-07T05:31:56Z',
        objectPropertyName: '<string>',
        updatedAt: '2023-11-07T05:31:56Z'
      }
    ],
    detailTemplate: '<string>',
    headerTemplate: '<string>'
  })
};

fetch('https://api.hubapi.com/integrators/timeline/v3/{appId}/event-templates/{eventTemplateId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.hubapi.com/integrators/timeline/v3/{appId}/event-templates/{eventTemplateId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'id' => '<string>',
    'name' => '<string>',
    'tokens' => [
        [
                'label' => '<string>',
                'name' => '<string>',
                'options' => [
                                [
                                                                'label' => '<string>',
                                                                'value' => '<string>'
                                ]
                ],
                'createdAt' => '2023-11-07T05:31:56Z',
                'objectPropertyName' => '<string>',
                'updatedAt' => '2023-11-07T05:31:56Z'
        ]
    ],
    'detailTemplate' => '<string>',
    'headerTemplate' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}
package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.hubapi.com/integrators/timeline/v3/{appId}/event-templates/{eventTemplateId}"

	payload := strings.NewReader("{\n  \"id\": \"<string>\",\n  \"name\": \"<string>\",\n  \"tokens\": [\n    {\n      \"label\": \"<string>\",\n      \"name\": \"<string>\",\n      \"options\": [\n        {\n          \"label\": \"<string>\",\n          \"value\": \"<string>\"\n        }\n      ],\n      \"createdAt\": \"2023-11-07T05:31:56Z\",\n      \"objectPropertyName\": \"<string>\",\n      \"updatedAt\": \"2023-11-07T05:31:56Z\"\n    }\n  ],\n  \"detailTemplate\": \"<string>\",\n  \"headerTemplate\": \"<string>\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.put("https://api.hubapi.com/integrators/timeline/v3/{appId}/event-templates/{eventTemplateId}")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"id\": \"<string>\",\n  \"name\": \"<string>\",\n  \"tokens\": [\n    {\n      \"label\": \"<string>\",\n      \"name\": \"<string>\",\n      \"options\": [\n        {\n          \"label\": \"<string>\",\n          \"value\": \"<string>\"\n        }\n      ],\n      \"createdAt\": \"2023-11-07T05:31:56Z\",\n      \"objectPropertyName\": \"<string>\",\n      \"updatedAt\": \"2023-11-07T05:31:56Z\"\n    }\n  ],\n  \"detailTemplate\": \"<string>\",\n  \"headerTemplate\": \"<string>\"\n}")
  .asString();
require 'uri'
require 'net/http'

url = URI("https://api.hubapi.com/integrators/timeline/v3/{appId}/event-templates/{eventTemplateId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"id\": \"<string>\",\n  \"name\": \"<string>\",\n  \"tokens\": [\n    {\n      \"label\": \"<string>\",\n      \"name\": \"<string>\",\n      \"options\": [\n        {\n          \"label\": \"<string>\",\n          \"value\": \"<string>\"\n        }\n      ],\n      \"createdAt\": \"2023-11-07T05:31:56Z\",\n      \"objectPropertyName\": \"<string>\",\n      \"updatedAt\": \"2023-11-07T05:31:56Z\"\n    }\n  ],\n  \"detailTemplate\": \"<string>\",\n  \"headerTemplate\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body
{
  "id": "<string>",
  "name": "<string>",
  "objectType": "<string>",
  "tokens": [
    {
      "label": "<string>",
      "name": "<string>",
      "options": [
        {
          "label": "<string>",
          "value": "<string>"
        }
      ],
      "createdAt": "2023-11-07T05:31:56Z",
      "objectPropertyName": "<string>",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "detailTemplate": "<string>",
  "headerTemplate": "<string>",
  "updatedAt": "2023-11-07T05:31:56Z"
}
{
  "message": "Invalid input (details will vary based on the error)",
  "correlationId": "aeb5f871-7f07-4993-9211-075dc63e7cbf",
  "category": "VALIDATION_ERROR",
  "links": {
    "knowledge-base": "https://www.hubspot.com/products/service/knowledge-base"
  }
}

Supported products

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
appId
integer<int32>
required
​
eventTemplateId
string
required

Body

application/json
​
id
string
required

The template ID.

​
name
string
required

The template name.

​
tokens
object[]
required

A collection of tokens that can be used as custom properties on the event and to create fully fledged CRM objects.

​
detailTemplate
string

This uses Markdown syntax with Handlebars and event-specific data to render HTML on a timeline when you expand the details.

​
headerTemplate
string

This uses Markdown syntax with Handlebars and event-specific data to render HTML on a timeline as a header.

Response

successful operation

​
id
string
required

The template ID.

​
name
string
required

The template name.

​
objectType
string
required

The type of CRM object this template is for. [Contacts, companies, tickets, and deals] are supported.

​
tokens
object[]
required

A collection of tokens that can be used as custom properties on the event and to create fully fledged CRM objects.

​
createdAt
string<date-time>

The date and time that the Event Template was created, as an ISO 8601 timestamp. Will be null if the template was created before Feb 18th, 2020.

​
detailTemplate
string

This uses Markdown syntax with Handlebars and event-specific data to render HTML on a timeline when you expand the details.

​
headerTemplate
string

This uses Markdown syntax with Handlebars and event-specific data to render HTML on a timeline as a header.

​
updatedAt
string<date-time>

The date and time that the Event Template was last updated, as an ISO 8601 timestamp. Will be null if the template was created before Feb 18th, 2020.

Last modified on March 30, 2026