Aller au contenu
Docs

Événements de modèle

Versions de modèle créées, mises à jour, publiées ou supprimées.

template.created

Envoyé lorsqu’une version de modèle est créée : avec Créer un modèle, en important un modèle dans le tableau de bord, ou en enregistrant une campagne comme modèle. Une version créée pour un nouvel alias est publiée immédiatement ; vérifiez published_at.

Les requêtes de webhook contiennent un tableau JSON d’événements comme celui-ci ; consultez Requêtes de webhook.

Champs

event_idstring

ID de l’événement (evt_…). Une requête relancée porte le même ID : utilisez-le pour ignorer les événements déjà traités. Vous pouvez aussi consulter l’événement avec Récupérer un événement.

typestring

Toujours template.created.

objectobject

La version de modèle décrite par l’événement. Ses champs sont détaillés ci-dessous.

data.objectobject

Le même objet, sous la forme que l’API des événements renvoie dans data.

Objet modèle

idstring

ID de la version de modèle (tem_…).

objectstring

Toujours template.

namestring

Nom du modèle.

aliasstring

Alias commun à toutes les versions du modèle.

fromstring | null

Expéditeur par défaut.

subjectstring | null

Ligne d’objet par défaut.

reply_tostring[] | null

Adresses de réponse par défaut.

htmlstring | null

Corps HTML.

textstring | null

Corps en texte brut.

editorstring

html, text, dragit ou tiptap.

published_atstring | null

Date de publication de cette version, ou null si ce n’est pas la version publiée.

created_atstring

Date de création de la version, au format ISO 8601 avec décalage UTC.

updated_atstring

Date de dernière mise à jour de la version.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "template.created",
  "object": {
    "id": "tem_2xKx7M2c9wQe3kHhJ8sVtY1pZ0a",
    "object": "template",
    "name": "Welcome email",
    "alias": "welcome-email",
    "from": "Acme <hello@acme.com>",
    "subject": "Welcome to Acme, {{ first_name }}",
    "reply_to": [
      "support@acme.com"
    ],
    "html": "<h1>Welcome, {{ first_name }}</h1>",
    "text": "Welcome, {{ first_name }}",
    "editor": "html",
    "published_at": "2026-09-30T10:30:00.482119+00:00",
    "created_at": "2026-09-30T10:30:00.482119+00:00",
    "updated_at": "2026-09-30T10:30:00.482119+00:00"
  },
  "data": {
    "object": {
      "id": "tem_2xKx7M2c9wQe3kHhJ8sVtY1pZ0a",
      "object": "template",
      "name": "Welcome email",
      "alias": "welcome-email",
      "from": "Acme <hello@acme.com>",
      "subject": "Welcome to Acme, {{ first_name }}",
      "reply_to": [
        "support@acme.com"
      ],
      "html": "<h1>Welcome, {{ first_name }}</h1>",
      "text": "Welcome, {{ first_name }}",
      "editor": "html",
      "published_at": "2026-09-30T10:30:00.482119+00:00",
      "created_at": "2026-09-30T10:30:00.482119+00:00",
      "updated_at": "2026-09-30T10:30:00.482119+00:00"
    }
  }
}

template.updated

Envoyé lorsqu’une version de modèle est modifiée avec Mettre à jour un modèle. La publication déclenche aussi cet événement : une fois pour la version que vous publiez et une fois pour chaque version de l’alias qui a été dépubliée. Utilisez published_at pour les distinguer.

Les requêtes de webhook contiennent un tableau JSON d’événements comme celui-ci ; consultez Requêtes de webhook.

Champs

event_idstring

ID de l’événement (evt_…). Une requête relancée porte le même ID : utilisez-le pour ignorer les événements déjà traités. Vous pouvez aussi consulter l’événement avec Récupérer un événement.

typestring

Toujours template.updated.

objectobject

La version de modèle décrite par l’événement. Ses champs sont détaillés ci-dessous.

data.objectobject

Le même objet, sous la forme que l’API des événements renvoie dans data.

Objet modèle

idstring

ID de la version de modèle (tem_…).

objectstring

Toujours template.

namestring

Nom du modèle.

aliasstring

Alias commun à toutes les versions du modèle.

fromstring | null

Expéditeur par défaut.

subjectstring | null

Ligne d’objet par défaut.

reply_tostring[] | null

Adresses de réponse par défaut.

htmlstring | null

Corps HTML.

textstring | null

Corps en texte brut.

editorstring

html, text, dragit ou tiptap.

published_atstring | null

Date de publication de cette version, ou null si ce n’est pas la version publiée.

created_atstring

Date de création de la version, au format ISO 8601 avec décalage UTC.

updated_atstring

Date de dernière mise à jour de la version.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "template.updated",
  "object": {
    "id": "tem_2xKx7M2c9wQe3kHhJ8sVtY1pZ0a",
    "object": "template",
    "name": "Welcome email",
    "alias": "welcome-email",
    "from": "Acme <hello@acme.com>",
    "subject": "Welcome to Acme, {{ first_name }}",
    "reply_to": [
      "support@acme.com"
    ],
    "html": "<h1>Welcome, {{ first_name }}</h1>",
    "text": "Welcome, {{ first_name }}",
    "editor": "html",
    "published_at": "2026-09-30T10:30:00.482119+00:00",
    "created_at": "2026-09-30T10:30:00.482119+00:00",
    "updated_at": "2026-10-01T10:02:14.307000+00:00"
  },
  "data": {
    "object": {
      "id": "tem_2xKx7M2c9wQe3kHhJ8sVtY1pZ0a",
      "object": "template",
      "name": "Welcome email",
      "alias": "welcome-email",
      "from": "Acme <hello@acme.com>",
      "subject": "Welcome to Acme, {{ first_name }}",
      "reply_to": [
        "support@acme.com"
      ],
      "html": "<h1>Welcome, {{ first_name }}</h1>",
      "text": "Welcome, {{ first_name }}",
      "editor": "html",
      "published_at": "2026-09-30T10:30:00.482119+00:00",
      "created_at": "2026-09-30T10:30:00.482119+00:00",
      "updated_at": "2026-10-01T10:02:14.307000+00:00"
    }
  }
}

template.deleted

Envoyé lorsqu’une version de modèle est supprimée avec Supprimer un modèle. Le payload correspond à la version telle qu’elle était avant sa suppression. S’il s’agissait de la version publiée, l’alias n’a plus de version publiée tant que vous n’en publiez pas une autre.

Les requêtes de webhook contiennent un tableau JSON d’événements comme celui-ci ; consultez Requêtes de webhook.

Champs

event_idstring

ID de l’événement (evt_…). Une requête relancée porte le même ID : utilisez-le pour ignorer les événements déjà traités. Vous pouvez aussi consulter l’événement avec Récupérer un événement.

typestring

Toujours template.deleted.

objectobject

La version de modèle décrite par l’événement. Ses champs sont détaillés ci-dessous.

data.objectobject

Le même objet, sous la forme que l’API des événements renvoie dans data.

Objet modèle

idstring

ID de la version de modèle (tem_…).

objectstring

Toujours template.

namestring

Nom du modèle.

aliasstring

Alias commun à toutes les versions du modèle.

fromstring | null

Expéditeur par défaut.

subjectstring | null

Ligne d’objet par défaut.

reply_tostring[] | null

Adresses de réponse par défaut.

htmlstring | null

Corps HTML.

textstring | null

Corps en texte brut.

editorstring

html, text, dragit ou tiptap.

published_atstring | null

Date de publication de cette version, ou null si ce n’est pas la version publiée.

created_atstring

Date de création de la version, au format ISO 8601 avec décalage UTC.

updated_atstring

Date de dernière mise à jour de la version.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "template.deleted",
  "object": {
    "id": "tem_2xKx7M2c9wQe3kHhJ8sVtY1pZ0a",
    "object": "template",
    "name": "Welcome email",
    "alias": "welcome-email",
    "from": "Acme <hello@acme.com>",
    "subject": "Welcome to Acme, {{ first_name }}",
    "reply_to": [
      "support@acme.com"
    ],
    "html": "<h1>Welcome, {{ first_name }}</h1>",
    "text": "Welcome, {{ first_name }}",
    "editor": "html",
    "published_at": "2026-09-30T10:30:00.482119+00:00",
    "created_at": "2026-09-30T10:30:00.482119+00:00",
    "updated_at": "2026-09-30T10:30:00.482119+00:00"
  },
  "data": {
    "object": {
      "id": "tem_2xKx7M2c9wQe3kHhJ8sVtY1pZ0a",
      "object": "template",
      "name": "Welcome email",
      "alias": "welcome-email",
      "from": "Acme <hello@acme.com>",
      "subject": "Welcome to Acme, {{ first_name }}",
      "reply_to": [
        "support@acme.com"
      ],
      "html": "<h1>Welcome, {{ first_name }}</h1>",
      "text": "Welcome, {{ first_name }}",
      "editor": "html",
      "published_at": "2026-09-30T10:30:00.482119+00:00",
      "created_at": "2026-09-30T10:30:00.482119+00:00",
      "updated_at": "2026-09-30T10:30:00.482119+00:00"
    }
  }
}

Cette page vous a-t-elle été utile ?

Merci pour votre retour.

Merci, nous lisons chaque message.

Esc

Populaires

↑↓pour naviguer↵pour ouvrirEscpour fermer