Zum Hauptinhalt springen
POST
/
integrators
/
timeline
/
v3
/
{appId}
/
event-templates
Create an event template
curl --request POST \
  --url https://api.hubapi.com/integrators/timeline/v3/{appId}/event-templates \
  --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 HubKostenlos
Sales HubSales HubKostenlos
Service HubService HubKostenlos
Content HubContent HubStarter

Authorizations

​
hapikey
string
query
required

Path Parameters

​
appId
integer
required

Die ID der Ziel-App.

Body

application/json

The new event template definition.

State of the template definition being created.

​
name
string
required

Der Vorlagenname.

Example:

"PetSpot Registration"

​
tokens
object[]
required

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

Example:

"[{\"name\":\"petName\",\"type\":\"string\",\"label\":\"Pet Name\"},{\"name\":\"petAge\",\"type\":\"number\",\"label\":\"Pet Age\"},{\"name\":\"petColor\",\"type\":\"enumeration\",\"label\":\"Pet Color\",\"options\":[{\"label\":\"White\",\"value\":\"white\"},{\"label\":\"Black\",\"value\":\"black\"},{\"label\":\"Brown\",\"value\":\"brown\"},{\"label\":\"Other\",\"value\":\"other\"}]}]"

​
objectType
string
required

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

Example:

"contacts"

​
detailTemplate
string

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

Example:

"Registration occurred at {{#formatDate timestamp}}{{/formatDate}}\n\n#### Questions\n{{#each extraData.questions}}\n **{{question}}**: {{answer}}\n{{/each}}"

​
headerTemplate
string

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

Example:

"Registered for [{{petName}}](https://my.petspot.com/pets/{{petName}})"

Response

successful operation

The current state of the template definition.

​
name
string
required

Der Vorlagenname.

​
tokens
object[]
required

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

​
id
string
required

Die Vorlagen-ID.

​
objectType
string
required

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

​
createdAt
string<date-time>

Der Zeitpunkt (Datum/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/Uhrzeit) der letzten Aktualisierung der Eventvorlage mit ISO 8601-Zeitstempel. Wird auf null gesetzt, wenn die Vorlage vor dem 18. Februar 2020 erstellt wurde.

⌘I