curl --request POST \
--url 'https://api.hubapi.com/integrators/timeline/v3/{appId}/event-templates?hapikey=' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"objectType": "<string>",
"tokens": [
{
"label": "<string>",
"name": "<string>",
"options": [
{
"label": "<string>",
"value": "<string>"
}
],
"type": "date",
"createdAt": "2023-11-07T05:31:56Z",
"objectPropertyName": "<string>",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"detailTemplate": "<string>",
"headerTemplate": "<string>"
}
'{
"id": "<string>",
"name": "<string>",
"objectType": "<string>",
"tokens": [
{
"label": "<string>",
"name": "<string>",
"options": [
{
"label": "<string>",
"value": "<string>"
}
],
"type": "date",
"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"
}Create an event template
Event templates define the general structure for a custom timeline event, and enable you to send event data to HubSpot. A template includes formatted copy for its heading and details, as well as any custom property definitions. A single app can include up to 750 event templates.
v1 and v3 timeline events APIs are only available for app partners with existing v1/v3 timeline events defined in their public app. - If your app doesn’t include any timeline events yet, requests to this endpoint will fail. Instead, you can get started on latest version of the developer platform. Note that you’ll need to request approval before you can define app events for your app. Learn more in the app events overview.
- If your app includes a
v1/v3timeline event, learn how to migrate it to the developer platform. You don’t need to request approval before migrating existing event types.
curl --request POST \
--url 'https://api.hubapi.com/integrators/timeline/v3/{appId}/event-templates?hapikey=' \
--header 'Content-Type: application/json' \
--data '
{
"name": "<string>",
"objectType": "<string>",
"tokens": [
{
"label": "<string>",
"name": "<string>",
"options": [
{
"label": "<string>",
"value": "<string>"
}
],
"type": "date",
"createdAt": "2023-11-07T05:31:56Z",
"objectPropertyName": "<string>",
"updatedAt": "2023-11-07T05:31:56Z"
}
],
"detailTemplate": "<string>",
"headerTemplate": "<string>"
}
'{
"id": "<string>",
"name": "<string>",
"objectType": "<string>",
"tokens": [
{
"label": "<string>",
"name": "<string>",
"options": [
{
"label": "<string>",
"value": "<string>"
}
],
"type": "date",
"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"
}Supported products
Supported products
Authorizations
Path Parameters
Body
The template name.
The type of CRM object this template is for. [Contacts, companies, tickets, and deals] are supported.
A collection of tokens that can be used as custom properties on the event and to create fully fledged CRM objects.
Show child attributes
Show child attributes
This uses Markdown syntax with Handlebars and event-specific data to render HTML on a timeline when you expand the details.
This uses Markdown syntax with Handlebars and event-specific data to render HTML on a timeline as a header.
Response
successful operation
The template ID.
The template name.
The type of CRM object this template is for. [Contacts, companies, tickets, and deals] are supported.
A collection of tokens that can be used as custom properties on the event and to create fully fledged CRM objects.
Show child attributes
Show child attributes
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.
This uses Markdown syntax with Handlebars and event-specific data to render HTML on a timeline when you expand the details.
This uses Markdown syntax with Handlebars and event-specific data to render HTML on a timeline as a header.
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.
Was this page helpful?