Create a new timeline event type

curl --request POST \
  --url https://api.hubapi.com/integrations/v1/{application-id}/timeline/event-types

[
  {
    "name": "New Event Type",
    "applicationId": "123",
    "objectType": "CONTACT",
    "headerTemplate": "# Title for event {{id}}\\nThis is an event for {{objectType}}",
    "detailTemplate": "This event happened on {{#formatDate timestamp}}{{/formatDate}}"
  },
  {
    "id": 261,
    "name": "Test Event Type",
    "headerTemplate": "# Title for event {{id}}\\nThis is an event for {{objectType}}",
    "detailTemplate": "This event happened on {{#formatDate timestamp}}{{/formatDate}}",
    "applicationId": 123,
    "objectType": "CONTACT"
  }
]

Create a new timeline event type

Create a new timeline event type template to begin sending event data to HubSpot.

the 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/v3 timeline event, learn how to migrate it to the developer platform. You don’t need to request approval before migrating existing event types.

If you’re not an app partner, you can send custom event data to HubSpot using the custom events API.

POST

integrations

{application-id}

timeline

event-types

Create a new timeline event type

curl --request POST \
  --url https://api.hubapi.com/integrations/v1/{application-id}/timeline/event-types

[
  {
    "name": "New Event Type",
    "applicationId": "123",
    "objectType": "CONTACT",
    "headerTemplate": "# Title for event {{id}}\\nThis is an event for {{objectType}}",
    "detailTemplate": "This event happened on {{#formatDate timestamp}}{{/formatDate}}"
  },
  {
    "id": 261,
    "name": "Test Event Type",
    "headerTemplate": "# Title for event {{id}}\\nThis is an event for {{objectType}}",
    "detailTemplate": "This event happened on {{#formatDate timestamp}}{{/formatDate}}",
    "applicationId": 123,
    "objectType": "CONTACT"
  }
]

Scope requirements

Response

200 - application/json

Successful response - Get the details of a specific timeline event type by its id

The response is of type object.

Last modified on March 30, 2026

⌘I