Documentation Webhooks ÉvĂ©nements

email.accepted

DĂ©clenchĂ© lorsqu’un e-mail est acceptĂ© pour livraison.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.accepted",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Bienvenue sur Emailit",
      "meta": { "campaign": "welcome-series" },
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Champs

id string

Identifiant unique de l’e-mail.

object string

Toujours email.

from string

Adresse e-mail de l’expĂ©diteur.

to string

Adresse e-mail du destinataire.

subject string

Objet de l’e-mail.

meta object | null

MĂ©tadonnĂ©es personnalisĂ©es associĂ©es Ă  l’e-mail.

created_at string

Horodatage ISO 8601 de crĂ©ation de l’e-mail.

email.scheduled

DĂ©clenchĂ© lorsqu’un e-mail est programmĂ© pour un envoi diffĂ©rĂ©.

{
  "event_id": "2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.scheduled",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Weekly Digest",
      "meta": { "series": "weekly" },
      "scheduled_at": "2026-02-15T09:00:00.000000+00:00",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Champs

id string

Identifiant unique de l’e-mail.

object string

Toujours email.

from string

Adresse e-mail de l’expĂ©diteur.

to string

Adresse e-mail du destinataire.

subject string

Objet de l’e-mail.

meta object | null

MĂ©tadonnĂ©es personnalisĂ©es associĂ©es Ă  l’e-mail.

scheduled_at string

Horodatage ISO 8601 de l’envoi programmĂ©.

created_at string

Horodatage ISO 8601 de crĂ©ation de l’e-mail.

email.delivered

DĂ©clenchĂ© lorsqu’un email est livrĂ© avec succĂšs au serveur de messagerie du destinataire.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.delivered",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Bienvenue sur Emailit",
      "status": "delivered",
      "meta": { "campaign": "welcome-series" },
      "updated_at": "2026-02-11T22:14:33.481927+00:00",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Champs

id string

Identifiant unique de l’email.

object string

Toujours email.

from string

Adresse email de l’expĂ©diteur.

to string

Adresse email du destinataire.

subject string

Objet de l’email.

status string

Toujours delivered.

meta object | null

MĂ©tadonnĂ©es personnalisĂ©es associĂ©es Ă  l’email.

updated_at string

Horodatage ISO 8601 du changement de statut.

created_at string

Horodatage ISO 8601 de crĂ©ation de l’email.

email.bounced

DĂ©clenchĂ© lorsqu’un email Ă©choue dĂ©finitivement Ă  la livraison (rebond dur).

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.bounced",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Bienvenue sur Emailit",
      "status": "bounced",
      "meta": { "campaign": "welcome-series" },
      "updated_at": "2026-02-11T22:14:33.481927+00:00",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Champs

id string

Identifiant unique de l’email.

object string

Toujours email.

from string

Adresse email de l’expĂ©diteur.

to string

Adresse email du destinataire.

subject string

Objet de l’email.

status string

Toujours bounced.

meta object | null

MĂ©tadonnĂ©es personnalisĂ©es associĂ©es Ă  l’email.

updated_at string

Horodatage ISO 8601 du changement de statut.

created_at string

Horodatage ISO 8601 de crĂ©ation de l’email.

email.attempted

DĂ©clenchĂ© lorsqu’une tentative de livraison d’email Ă©choue temporairement.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.attempted",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Welcome to Emailit",
      "status": "attempted",
      "meta": { "campaign": "welcome-series" },
      "updated_at": "2026-02-11T22:14:33.481927+00:00",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Champs

id string

Identifiant unique de l’email.

object string

Toujours email.

from string

Adresse email de l’expĂ©diteur.

to string

Adresse email du destinataire.

subject string

Objet de l’email.

status string

Toujours attempted.

meta object | null

MĂ©tadonnĂ©es personnalisĂ©es associĂ©es Ă  l’email.

updated_at string

Horodatage ISO 8601 du changement de statut.

created_at string

Horodatage ISO 8601 de crĂ©ation de l’email.

email.failed

DĂ©clenchĂ© lorsqu’un e-mail n’a pas pu ĂȘtre livrĂ©, gĂ©nĂ©ralement en raison d’une erreur spĂ©cifique lors de la livraison.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.failed",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Bienvenue sur Emailit",
      "status": "failed",
      "meta": { "campaign": "welcome-series" },
      "updated_at": "2026-02-11T22:14:33.481927+00:00",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Champs

id string

Identifiant unique de l’e-mail.

object string

Toujours email.

from string

Adresse e-mail de l’expĂ©diteur.

to string

Adresse e-mail du destinataire.

subject string

Objet de l’e-mail.

status string

Toujours failed.

meta object | null

MĂ©tadonnĂ©es personnalisĂ©es associĂ©es Ă  l’e-mail.

updated_at string

Horodatage ISO 8601 du changement de statut.

created_at string

Horodatage ISO 8601 de crĂ©ation de l’e-mail.

email.rejected

DĂ©clenchĂ© lorsqu’un e-mail a Ă©tĂ© acceptĂ© pour livraison mais rejetĂ© par la suite.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.rejected",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Bienvenue sur Emailit",
      "status": "rejected",
      "meta": { "campaign": "welcome-series" },
      "updated_at": "2026-02-11T22:14:33.481927+00:00",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Champs

id string

Identifiant unique de l’e-mail.

object string

Toujours email.

from string

Adresse e-mail de l’expĂ©diteur.

to string

Adresse e-mail du destinataire.

subject string

Objet de l’e-mail.

status string

Toujours rejected.

meta object | null

MĂ©tadonnĂ©es personnalisĂ©es associĂ©es Ă  l’e-mail.

updated_at string

Horodatage ISO 8601 du changement de statut.

created_at string

Horodatage ISO 8601 de crĂ©ation de l’e-mail.

email.suppressed

DĂ©clenchĂ© lorsque le destinataire de l’e-mail figure sur la liste de suppression.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.suppressed",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Bienvenue sur Emailit",
      "status": "suppressed",
      "meta": { "campaign": "welcome-series" },
      "updated_at": "2026-02-11T22:14:33.481927+00:00",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Champs

id string

Identifiant unique de l’e-mail.

object string

Toujours email.

from string

Adresse e-mail de l’expĂ©diteur.

to string

Adresse e-mail du destinataire.

subject string

Objet de l’e-mail.

status string

Toujours suppressed.

meta object | null

MĂ©tadonnĂ©es personnalisĂ©es associĂ©es Ă  l’e-mail.

updated_at string

Horodatage ISO 8601 du changement de statut.

created_at string

Horodatage ISO 8601 de crĂ©ation de l’e-mail.

email.received

DĂ©clenchĂ© lorsqu’un email entrant est acceptĂ©.

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.received",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Welcome to Emailit",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Champs

id string

Identifiant unique de l’email.

object string

Toujours email.

from string

Adresse email de l’expĂ©diteur.

to string

Adresse email du destinataire.

subject string

Objet de l’email.

created_at string

Horodatage ISO 8601 de la rĂ©ception de l’email.

email.complained

DĂ©clenchĂ© lorsqu’une plainte est enregistrĂ©e pour cet e-mail (par exemple, marquĂ© comme spam).

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.complained",
  "data": {
    "object": {
      "id": "em_4yM2nTvR8oPcX3uZiKeLg7sB",
      "object": "email",
      "from": "sender@example.com",
      "to": "recipient@example.com",
      "subject": "Welcome to Emailit",
      "status": "complained",
      "meta": { "campaign": "welcome-series" },
      "updated_at": "2026-02-11T22:14:33.481927+00:00",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Champs

id string

Identifiant unique de l’e-mail.

object string

Toujours email.

from string

Adresse e-mail de l’expĂ©diteur.

to string

Adresse e-mail du destinataire.

subject string

Objet de l’e-mail.

status string

Toujours complained.

meta object | null

MĂ©tadonnĂ©es personnalisĂ©es associĂ©es Ă  l’e-mail.

updated_at string

Horodatage ISO 8601 du changement de statut.

created_at string

Horodatage ISO 8601 de la crĂ©ation de l’e-mail.

email.clicked

DĂ©clenchĂ© lorsqu’un lien dans un email est cliquĂ©. Inclut les dĂ©tails du clic tels que l’adresse IP, l’agent utilisateur et l’URL qui a Ă©tĂ© cliquĂ©e.

{
  "event_id": "...",
  "type": "email.clicked",
  "data": {
    "object": {
      "id": "click_4yM2nTvR8oPcX3u...",
      "object": "click",
      "email": {
        "id": "em_...",
        "rcpt_to": "recipient@example.com",
        "mail_from": "sender@example.com",
        "subject": "Welcome",
        "created_at": "...",
        "meta": null
      },
      "link": {
        "id": "link_...",
        "url": "https://example.com/page"
      },
      "ip_address": "203.0.113.42",
      "user_agent": "Mozilla/5.0 ...",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Champs

id string

Identifiant unique du clic.

object string

Toujours click.

email object

L’email qui a Ă©tĂ© cliquĂ©.

email.id string

Identifiant de l’email.

email.rcpt_to string

Adresse email du destinataire.

email.mail_from string

Adresse email de l’expĂ©diteur.

email.subject string

Objet de l’email.

email.meta object | null

MĂ©tadonnĂ©es personnalisĂ©es associĂ©es Ă  l’email.

link.id string

Identifiant du lien.

link.url string

L’URL qui a Ă©tĂ© cliquĂ©e.

ip_address string

Adresse IP du clic.

user_agent string

Chaüne d’agent utilisateur du client.

created_at string

Horodatage ISO 8601 du clic.

email.loaded

DĂ©clenchĂ© lorsque le contenu d’un email est chargĂ© par le destinataire. Inclut les dĂ©tails de suivi tels que l’adresse IP et l’agent utilisateur.

{
  "event_id": "...",
  "type": "email.loaded",
  "data": {
    "object": {
      "id": "load_4yM2nTvR8oPcX3u...",
      "object": "load",
      "email": {
        "id": "em_...",
        "rcpt_to": "destinataire@exemple.com",
        "mail_from": "expediteur@exemple.com",
        "subject": "Bienvenue",
        "created_at": "...",
        "meta": null
      },
      "ip_address": "203.0.113.42",
      "user_agent": "Mozilla/5.0 ...",
      "created_at": "2026-02-11T22:14:33.481927+00:00"
    }
  }
}

Champs

id string

Identifiant unique du chargement.

object string

Toujours load.

email object

L’email qui a Ă©tĂ© chargĂ©.

email.id string

Identifiant de l’email.

email.rcpt_to string

Adresse email du destinataire.

email.mail_from string

Adresse email de l’expĂ©diteur.

email.subject string

Objet de l’email.

email.meta object | null

MĂ©tadonnĂ©es personnalisĂ©es associĂ©es Ă  l’email.

ip_address string

Adresse IP du chargement.

user_agent string

Chaüne d’agent utilisateur du client.

created_at string

Horodatage ISO 8601 du chargement.

Localisé par IA