Zum Hauptinhalt springen
POST
/
integrators
/
timeline
/
v3
/
{appId}
/
event-templates
Eine Event-Vorlage erstellen
curl --request POST \
  --url 'https://api.hubapi.com/integrators/timeline/v3/{appId}/event-templates?hapikey=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "PetSpot Registration",
  "objectType": "contacts",
  "headerTemplate": "Registered for [{{petName}}](https://my.petspot.com/pets/{{petName}})",
  "detailTemplate": "Registration occurred at {{#formatDate timestamp}}{{/formatDate}}\n\n#### Questions\n{{#each extraData.questions}}\n  **{{question}}**: {{answer}}\n{{/each}}",
  "tokens": [
    {
      "name": "petName",
      "label": "Pet Name",
      "type": "string"
    },
    {
      "name": "petAge",
      "label": "Pet Age",
      "type": "number"
    },
    {
      "name": "petColor",
      "label": "Pet Color",
      "type": "enumeration",
      "options": [
        {
          "value": "white",
          "label": "White"
        },
        {
          "value": "black",
          "label": "Black"
        },
        {
          "value": "brown",
          "label": "Brown"
        },
        {
          "value": "other",
          "label": "Other"
        }
      ]
    }
  ]
}
'
{
  "id": "1001298",
  "objectType": "contacts",
  "createdAt": "2020-02-12T20:58:26Z",
  "updatedAt": "2020-02-12T20:58:26Z",
  "name": "PetSpot Registration",
  "headerTemplate": "Registered for [{{petName}}](https://my.petspot.com/pets/{{petName}})",
  "detailTemplate": "Registration occurred at {{#formatDate timestamp}}{{/formatDate}}\n\n#### Questions\n{{#each extraData.questions}}\n  **{{question}}**: {{answer}}\n{{/each}}",
  "tokens": [
    {
      "name": "petName",
      "type": "string",
      "createdAt": "2020-02-12T20:58:26Z",
      "updatedAt": "2020-02-12T20:58:26Z",
      "label": "Pet Name",
      "options": []
    },
    {
      "name": "petAge",
      "type": "number",
      "createdAt": "2020-02-12T20:58:26Z",
      "updatedAt": "2020-02-12T20:58:26Z",
      "label": "Pet Age",
      "options": []
    },
    {
      "name": "petColor",
      "type": "enumeration",
      "createdAt": "2020-02-12T20:58:26Z",
      "updatedAt": "2020-02-12T20:58:26Z",
      "label": "Pet Color",
      "options": [
        {
          "value": "white",
          "label": "White"
        },
        {
          "value": "black",
          "label": "Black"
        },
        {
          "value": "brown",
          "label": "Brown"
        },
        {
          "value": "other",
          "label": "Other"
        }
      ]
    }
  ]
}

Unterstützte Produkte

Erfordert eines der folgenden Produkte oder höher.
Marketing HubMarketing Hub -Kostenlos
Sales HubSales Hub -Kostenlos
Service HubService Hub -Kostenlos
Content HubContent Hub -Kostenlos

Autorisierungen

hapikey
string
query
erforderlich

Pfadparameter

appId
integer<int32>
erforderlich

Die ID der Ziel-App.

Body

application/json

The new event template definition.

State of the template definition being created.

name
string
erforderlich

Der Vorlagenname.

objectType
string
erforderlich

Der Typ des CRM-Objekts, für das diese Vorlage gilt. Unterstützt werden [Kontakte, Unternehmen, Tickets und Deals].

tokens
object[]
erforderlich

Eine Filtergruppe mit Token, die als benutzerdefinierte Eigenschaften für das Event und zum Erstellen vollwertiger CRM-Objekte verwendet werden können.

detailTemplate
string

Dabei wird die Markdown-Syntax mit Handlebars und eventspezifischen Daten verwendet, um HTML in einer Chronik darzustellen, wenn die Details erweitert werden.

headerTemplate
string

Dabei wird die Markdown-Syntax mit Handlebars und eventspezifischen Daten verwendet, um HTML in einer Chronik als Header darzustellen.

Antwort

successful operation

The current state of the template definition.

id
string
erforderlich

Die Vorlagen-ID.

name
string
erforderlich

Der Vorlagenname.

objectType
string
erforderlich

Der Typ des CRM-Objekts, für das diese Vorlage gilt. Unterstützt werden [Kontakte, Unternehmen, Tickets und Deals].

tokens
object[]
erforderlich

Eine Filtergruppe mit Token, die als benutzerdefinierte Eigenschaften für das Event und zum Erstellen vollwertiger CRM-Objekte verwendet werden können.

createdAt
string<date-time>

Der Zeitpunkt (Datum und Uhrzeit), an dem die Event-Vorlage erstellt wurde (ISO 8601-Zeitstempel). Wird auf null gesetzt, wenn die Vorlage vor dem 18. Februar 2020 erstellt wurde.

detailTemplate
string

Dabei wird die Markdown-Syntax mit Handlebars und eventspezifischen Daten verwendet, um HTML in einer Chronik darzustellen, wenn die Details erweitert werden.

headerTemplate
string

Dabei wird die Markdown-Syntax mit Handlebars und eventspezifischen Daten verwendet, um HTML in einer Chronik als Header darzustellen.

updatedAt
string<date-time>

Der Zeitpunkt (Datum und Uhrzeit) der letzten Aktualisierung der Eventvorlage mit ISO 8601-Zeitstempel. Wird auf null gesetzt, wenn die Vorlage vor dem 18. Februar 2020 erstellt wurde.

Last modified on December 10, 2025