Envoyer des événements depuis votre backend

Envoyez les événements depuis vos serveurs pour tout ce qui ne doit pas dépendre du navigateur du visiteur, comme les commandes, les paiements, les changements d’abonnement ou les événements d’un back-office. Cette page montre comment envoyer un événement, comment en envoyer plusieurs et comment gérer les erreurs.

Avant de commencer

• L’envoi d’événements est inclus dans les forfaits Pro, Business et Custom. Un espace de travail Pro peut utiliser 100 types d’événements et un espace de travail Business 1 000. Consultez Limites.
• Créez une clé API avec la portée Events Only dans Email API›API Keys. Elle peut envoyer des événements et rien d’autre : elle ne peut ni lire vos données, ni gérer les définitions d’événements, ni envoyer d’e-mails. Une clé Full Access fonctionne aussi. Consultez Clés API.
• Pour envoyer des événements d’espace de travail, définissez-les d’abord. Les événements personnalisés ne demandent aucune configuration.

Envoyer un événement

Appelez Envoyer un événement avec le type de l’événement, ses properties et la personne qu’il concerne :

curl -X POST https://api.emailit.com/v2/events \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "c:order.completed",
    "email": "jane@example.com",
    "properties": { "order_id": "1001", "total": 59.9, "currency": "EUR" },
    "occurred_at": "2026-10-19T09:30:00Z"
  }'

• email rattache l’événement au contact qui a cette adresse. Si vous connaissez déjà l’ID du contact, envoyez plutôt contact_id.
• occurred_at indique quand l’événement s’est produit, par exemple lorsque vous envoyez des événements depuis une file d’attente. Omettez-le pour utiliser l’heure actuelle.
• La réponse est 201, avec l’événement enregistré et son ID evt_. Une clé Events Only reçoit l’événement sans data.

Envoyer plusieurs événements à la fois

Envoyer des événements par lot accepte jusqu’à 100 événements en une seule requête, ce qui convient aux imports et aux synchronisations planifiées :

curl -X POST https://api.emailit.com/v2/events/batch \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "events": [
      { "type": "c:order.completed", "email": "jane@example.com", "properties": { "order_id": "1001", "total": 59.9 } },
      { "type": "c:order.completed", "email": "omar@example.com", "properties": { "order_id": "1002", "total": 18 } }
    ]
  }'

Un lot est traité en tout ou rien : si un événement est invalide, aucun n’est enregistré. La réponse 422 liste chaque problème sous events.<index> : vous pouvez ainsi corriger ou retirer ces événements, puis renvoyer le lot.

Gérer les erreurs

Les événements n’ont pas de clé d’idempotence : relancer une requête qui a abouti enregistre donc l’événement deux fois. Placez votre propre ID dans les propriétés, comme order_id, pour que quiconque lit les événements puisse reconnaître les doublons.

Vérifier que les événements arrivent

Ouvrez Email API›Events. L’onglet Log liste les nouveaux événements en haut ; réglez Scope sur Custom ou Workspace pour masquer les événements système. Sélectionnez un événement pour voir ses propriétés, le contact auquel il appartient et sa provenance. Les événements rattachés à un contact apparaissent aussi dans l’Activity log du contact.

Voir aussi