Eventi delle email

Il ciclo di vita di ogni email in uscita e in entrata, dall’accettazione alla consegna, ad aperture, clic e disiscrizioni.

email.accepted
email.scheduled
email.delivered
email.attempted
email.bounced
email.failed
email.rejected
email.suppressed
email.held
email.canceled
email.complained
email.received
email.loaded
email.clicked
email.unsubscribed
email.resubscribed

email.accepted

Inviato quando Invia un’email o Inoltra un’email accetta un’email per la consegna immediata. Emailit invia un evento per destinatario, perché ogni destinatario riceve il proprio ID email. Le email inviate tramite SMTP e quelle create con Ritenta un’email non generano questo evento.

Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.

Campi

event_idstring

ID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.

typestring

Sempre email.accepted.

objectobject

L’email descritta dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto email

idstring

ID dell’email (em_…).

objectstring

Sempre email.

fromstring

Mittente così come indicato nella richiesta. Può includere un nome visualizzato, ad esempio Acme <hello@acme.com>.

tostring

Indirizzo del destinatario. Emailit crea un’email separata, con il proprio ID, per ogni destinatario.

subjectstring

Riga dell’oggetto.

metaobject | null

L’oggetto meta che hai inviato con l’email, oppure null.

timestampstring

Quando è stata accettata l’email, in formato ISO 8601 con offset UTC.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.accepted",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "meta": {
      "order_id": "1042"
    },
    "timestamp": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "Acme <hello@acme.com>",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "meta": {
        "order_id": "1042"
      },
      "timestamp": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.scheduled

Inviato quando Invia un’email accetta un’email con un scheduled_at nel futuro. Emailit invia un evento per destinatario. Quando arriva l’orario programmato, Emailit invia l’email senza un evento email.accepted; l’evento successivo è un evento di consegna come email.delivered.

Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.

Campi

event_idstring

ID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.

typestring

Sempre email.scheduled.

objectobject

L’email descritta dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto email

idstring

ID dell’email (em_…).

objectstring

Sempre email.

fromstring

Mittente così come indicato nella richiesta. Può includere un nome visualizzato, ad esempio Acme <hello@acme.com>.

tostring

Indirizzo del destinatario. Emailit crea un’email separata, con il proprio ID, per ogni destinatario.

subjectstring

Riga dell’oggetto.

metaobject | null

L’oggetto meta che hai inviato con l’email, oppure null.

scheduled_atstring

Quando Emailit invierà l’email.

timestampstring

Quando è stata accettata l’email, in formato ISO 8601 con offset UTC.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.scheduled",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Your October invoice",
    "meta": {
      "invoice_id": "INV-2026-0142"
    },
    "scheduled_at": "2026-10-02T09:00:00.000000+00:00",
    "timestamp": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "Acme <hello@acme.com>",
      "to": "ada@example.com",
      "subject": "Your October invoice",
      "meta": {
        "invoice_id": "INV-2026-0142"
      },
      "scheduled_at": "2026-10-02T09:00:00.000000+00:00",
      "timestamp": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.delivered

Inviato quando il server di posta del destinatario accetta l’email. Consegnata significa che il server ricevente si è preso la responsabilità del messaggio; può comunque filtrarlo nella cartella spam. Stati delle email spiega ogni stato.

Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.

Campi

event_idstring

ID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.

typestring

Sempre email.delivered.

objectobject

L’email descritta dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto email

idstring

ID dell’email (em_…).

objectstring

Sempre email.

fromstring

Indirizzo del mittente, senza il nome visualizzato.

tostring

Indirizzo del destinatario. Emailit crea un’email separata per ogni destinatario.

subjectstring | null

Riga dell’oggetto.

statusstring

Sempre delivered.

metaobject | null

L’oggetto meta inviato con l’email, oppure null.

updated_atstring

Quando il record dell’email è stato aggiornato l’ultima volta prima di questo evento, in formato ISO 8601 con offset UTC. Può essere precedente al cambio di stato stesso.

created_atstring

Quando Emailit ha accettato l’email.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.delivered",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "delivered",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "delivered",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.attempted

Inviato ogni volta che un tentativo di consegna non riesce per un errore temporaneo, come il greylisting o un limite di frequenza del server ricevente, ed Emailit ritenterà. Emailit continua a ritentare a intervalli crescenti per circa 21 ore; se la consegna continua a non riuscire, l’email risulta rimbalzata e ricevi email.bounced.

Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.

Campi

event_idstring

ID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.

typestring

Sempre email.attempted.

objectobject

L’email descritta dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto email

idstring

ID dell’email (em_…).

objectstring

Sempre email.

fromstring

Indirizzo del mittente, senza il nome visualizzato.

tostring

Indirizzo del destinatario. Emailit crea un’email separata per ogni destinatario.

subjectstring | null

Riga dell’oggetto.

statusstring

Sempre attempted.

metaobject | null

L’oggetto meta inviato con l’email, oppure null.

updated_atstring

Quando il record dell’email è stato aggiornato l’ultima volta prima di questo evento, in formato ISO 8601 con offset UTC. Può essere precedente al cambio di stato stesso.

created_atstring

Quando Emailit ha accettato l’email.

smtp_codeinteger | null

Codice di risposta SMTP del server ricevente, ad esempio 421. null quando è stato Emailit stesso a rinviare il tentativo, ad esempio durante un backoff delle consegne verso quel server.

smtp_enhanced_codestring | null

Codice di stato esteso della risposta, ad esempio 4.7.0. Vedi Codici di stato estesi.

smtp_responsestring | null

Risposta completa del server ricevente.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.attempted",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "attempted",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00",
    "smtp_code": 421,
    "smtp_enhanced_code": "4.7.0",
    "smtp_response": "421 4.7.0 Try again later, closing connection."
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "attempted",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00",
      "smtp_code": 421,
      "smtp_enhanced_code": "4.7.0",
      "smtp_response": "421 4.7.0 Try again later, closing connection."
    }
  }
}

email.bounced

Inviato quando un’email non può essere consegnata: il server ricevente l’ha rifiutata con un errore permanente, è arrivata una notifica di bounce dopo la consegna, tutti i nuovi tentativi non sono riusciti, oppure Emailit non è riuscito affatto a inviarla, ad esempio perché il suo dominio di invio è stato eliminato. In base alle impostazioni di soppressione automatica, Emailit sopprime anche l’indirizzo. Vedi Bounce e segnalazioni di spam.

Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.

Campi

event_idstring

ID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.

typestring

Sempre email.bounced.

objectobject

L’email descritta dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto email

idstring

ID dell’email (em_…).

objectstring

Sempre email.

fromstring

Indirizzo del mittente, senza il nome visualizzato.

tostring

Indirizzo del destinatario. Emailit crea un’email separata per ogni destinatario.

subjectstring | null

Riga dell’oggetto.

statusstring

Sempre bounced.

metaobject | null

L’oggetto meta inviato con l’email, oppure null.

updated_atstring

Quando il record dell’email è stato aggiornato l’ultima volta prima di questo evento, in formato ISO 8601 con offset UTC. Può essere precedente al cambio di stato stesso.

created_atstring

Quando Emailit ha accettato l’email.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.bounced",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "bounced",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "bounced",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.failed

Inviato quando Emailit non riesce a elaborare una notifica di bounce arrivata all’indirizzo return path del workspace, ad esempio a causa di un errore interno. L’oggetto descrive il messaggio di bounce, non l’email che hai inviato. Questo evento è raro: le consegne non riuscite generano email.bounced o email.attempted.

Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.

Campi

event_idstring

ID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.

typestring

Sempre email.failed.

objectobject

Il messaggio di bounce descritto dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto email

idstring

ID dell’email (em_…) del messaggio di bounce.

objectstring

Sempre email.

fromstring

Mittente del messaggio di bounce, di solito il mailer daemon del server ricevente.

tostring

L’indirizzo return path del workspace sul sottodominio emailit. del dominio di invio.

subjectstring | null

Riga dell’oggetto del messaggio di bounce.

statusstring

Sempre failed.

metaobject | null

Sempre null per i messaggi di bounce.

updated_atstring

Quando il messaggio di bounce è stato aggiornato l’ultima volta prima di questo evento, in formato ISO 8601 con offset UTC.

created_atstring

Quando Emailit ha ricevuto il messaggio di bounce.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.failed",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "mailer-daemon@mx1.example.com",
    "to": "2xKw0aNf5Zs8Yt1Lq4Ve7Mc3Pb6@emailit.acme.com",
    "subject": "Undelivered Mail Returned to Sender",
    "status": "failed",
    "meta": null,
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "mailer-daemon@mx1.example.com",
      "to": "2xKw0aNf5Zs8Yt1Lq4Ve7Mc3Pb6@emailit.acme.com",
      "subject": "Undelivered Mail Returned to Sender",
      "status": "failed",
      "meta": null,
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.rejected

Inviato quando Emailit si rifiuta di inviare un’email perché il workspace non ha ancora l’accesso alla produzione e il destinatario non è un membro del workspace. Finché il workspace non viene approvato, puoi inviare solo agli indirizzi degli account dei membri del workspace.

Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.

Campi

event_idstring

ID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.

typestring

Sempre email.rejected.

objectobject

L’email descritta dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto email

idstring

ID dell’email (em_…).

objectstring

Sempre email.

fromstring

Indirizzo del mittente, senza il nome visualizzato.

tostring

Indirizzo del destinatario. Emailit crea un’email separata per ogni destinatario.

subjectstring | null

Riga dell’oggetto.

statusstring

Sempre rejected.

metaobject | null

L’oggetto meta inviato con l’email, oppure null.

updated_atstring

Quando il record dell’email è stato aggiornato l’ultima volta prima di questo evento, in formato ISO 8601 con offset UTC. Può essere precedente al cambio di stato stesso.

created_atstring

Quando Emailit ha accettato l’email.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.rejected",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "rejected",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "rejected",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.suppressed

Inviato quando Emailit non invia un’email perché il destinatario ha una soppressione recipient nella lista di soppressione. Per scrivere di nuovo all’indirizzo, rimuovilo con Elimina una soppressione.

Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.

Campi

event_idstring

ID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.

typestring

Sempre email.suppressed.

objectobject

L’email descritta dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto email

idstring

ID dell’email (em_…).

objectstring

Sempre email.

fromstring

Indirizzo del mittente, senza il nome visualizzato.

tostring

Indirizzo del destinatario. Emailit crea un’email separata per ogni destinatario.

subjectstring | null

Riga dell’oggetto.

statusstring

Sempre suppressed.

metaobject | null

L’oggetto meta inviato con l’email, oppure null.

updated_atstring

Quando il record dell’email è stato aggiornato l’ultima volta prima di questo evento, in formato ISO 8601 con offset UTC. Può essere precedente al cambio di stato stesso.

created_atstring

Quando Emailit ha accettato l’email.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.suppressed",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "suppressed",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "suppressed",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.held

Inviato quando Emailit trattiene un’email invece di inviarla. Succede quando il workspace è sospeso, il dominio di invio è in pausa, la chiave API è impostata per trattenere i messaggi, il workspace ha esaurito i crediti, oppure il punteggio del controllo antispam è pari o superiore alla soglia (7 per impostazione predefinita). Dopo aver risolto la causa, invia di nuovo l’email con Ritenta un’email.

email.held non è nell’elenco degli eventi del pannello. Lo ricevi sui webhook che hanno all_events attivo, oppure aggiungendolo a events con Aggiorna un webhook.

Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.

Campi

event_idstring

ID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.

typestring

Sempre email.held.

objectobject

L’email descritta dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto email

idstring

ID dell’email (em_…).

objectstring

Sempre email.

fromstring

Indirizzo del mittente, senza il nome visualizzato.

tostring

Indirizzo del destinatario. Emailit crea un’email separata per ogni destinatario.

subjectstring | null

Riga dell’oggetto.

statusstring

Sempre held.

metaobject | null

L’oggetto meta inviato con l’email, oppure null.

updated_atstring

Quando il record dell’email è stato aggiornato l’ultima volta prima di questo evento, in formato ISO 8601 con offset UTC. Può essere precedente al cambio di stato stesso.

created_atstring

Quando Emailit ha accettato l’email.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.held",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "held",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "held",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.canceled

Inviato quando annulli un’email con Annulla un’email. Se era già in corso un tentativo di consegna, questo può comunque completarsi, quindi può seguire un evento di consegna.

Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.

Campi

event_idstring

ID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.

typestring

Sempre email.canceled.

objectobject

L’email descritta dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto email

idstring

ID dell’email (em_…).

objectstring

Sempre email.

fromstring

Mittente così come è salvato nell’email. Può includere un nome visualizzato.

tostring

Indirizzo del destinatario.

subjectstring

Riga dell’oggetto.

statusstring

Sempre canceled.

previous_statusstring

Stato prima dell’annullamento: scheduled, accepted o attempted.

metaobject | null

L’oggetto meta inviato con l’email, oppure null.

timestampstring

Quando è stata annullata l’email, in formato ISO 8601 con offset UTC.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.canceled",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "Acme <hello@acme.com>",
    "to": "ada@example.com",
    "subject": "Your October invoice",
    "status": "canceled",
    "previous_status": "scheduled",
    "meta": {
      "invoice_id": "INV-2026-0142"
    },
    "timestamp": "2026-10-01T10:02:14.307000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "Acme <hello@acme.com>",
      "to": "ada@example.com",
      "subject": "Your October invoice",
      "status": "canceled",
      "previous_status": "scheduled",
      "meta": {
        "invoice_id": "INV-2026-0142"
      },
      "timestamp": "2026-10-01T10:02:14.307000+00:00"
    }
  }
}

email.complained

Inviato quando un destinatario contrassegna la tua email come spam e il suo provider di posta lo comunica a Emailit tramite un feedback loop. In base alle impostazioni di soppressione automatica, Emailit aggiunge una soppressione complaint per l’indirizzo. Vedi Bounce e segnalazioni di spam.

Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.

Campi

event_idstring

ID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.

typestring

Sempre email.complained.

objectobject

L’email descritta dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto email

idstring

ID dell’email (em_…).

objectstring

Sempre email.

fromstring

Indirizzo del mittente, senza il nome visualizzato.

tostring

Indirizzo del destinatario. Emailit crea un’email separata per ogni destinatario.

subjectstring | null

Riga dell’oggetto.

statusstring

Sempre complained.

metaobject | null

L’oggetto meta inviato con l’email, oppure null.

updated_atstring

Quando il record dell’email è stato aggiornato l’ultima volta prima di questo evento, in formato ISO 8601 con offset UTC. Può essere precedente al cambio di stato stesso.

created_atstring

Quando Emailit ha accettato l’email.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.complained",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "hello@acme.com",
    "to": "ada@example.com",
    "subject": "Your order has shipped",
    "status": "complained",
    "meta": {
      "order_id": "1042"
    },
    "updated_at": "2026-10-01T10:02:12.104000+00:00",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "hello@acme.com",
      "to": "ada@example.com",
      "subject": "Your order has shipped",
      "status": "complained",
      "meta": {
        "order_id": "1042"
      },
      "updated_at": "2026-10-01T10:02:12.104000+00:00",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.received

Inviato quando Emailit riceve un’email a uno dei tuoi indirizzi per le email in entrata. Il payload contiene solo la busta: recupera il corpo e gli allegati con Recupera un’email usando l’id.

Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.

Campi

event_idstring

ID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.

typestring

Sempre email.received.

objectobject

L’email ricevuta descritta dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto email

idstring

ID dell’email (em_…) ricevuta.

objectstring

Sempre email.

fromstring

Indirizzo del mittente preso dall’header From.

tostring

Indirizzo di ricezione che ha ricevuto l’email.

subjectstring | null

Riga dell’oggetto.

created_atstring

Quando Emailit ha ricevuto l’email, in formato ISO 8601 con offset UTC.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.received",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "ada@example.com",
    "to": "support@inbound.acme.com",
    "subject": "Question about my order",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "ada@example.com",
      "to": "support@inbound.acme.com",
      "subject": "Question about my order",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

email.loaded

Inviato ogni volta che si carica il pixel di tracciamento di un’email, il che di solito significa che il destinatario l’ha aperta. Il tracciamento delle aperture richiede un dominio di tracciamento verificato e il tracciamento delle aperture attivo per l’email. I client di posta che precaricano o bloccano le immagini rendono le aperture approssimative.

Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.

Campi

event_idstring

ID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.

typestring

Sempre email.loaded.

objectobject

L’apertura descritta dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto caricamento

idstring

ID dell’apertura (load_…).

objectstring

Sempre load.

email_idstring

ID dell’email (em_…).

emailobject

L’email.

email.idstring

ID dell’email (em_…).

email.rcpt_tostring

Indirizzo del destinatario.

email.mail_fromstring

Mittente così come è salvato nell’email. Può includere un nome visualizzato.

email.subjectstring | null

Riga dell’oggetto.

email.created_atstring

Quando Emailit ha accettato l’email.

email.campaignobject | null

id e name della campagna che ha inviato l’email, oppure null per le email inviate tramite API o SMTP.

email.metaobject | null

L’oggetto meta inviato con l’email, oppure null.

contactobject | null

id e email del contatto che ha l’indirizzo del destinatario in questo workspace, oppure null se non esiste.

ip_addressstring

Indirizzo IP della richiesta.

user_agentstring | null

User agent del client che ha inviato la richiesta.

created_atstring

Quando si è caricato il pixel, in formato ISO 8601 con offset UTC.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.loaded",
  "object": {
    "id": "load_2xLg2Cw7Sr4Xo9Ud1Zn6Ke3Lt8g",
    "object": "load",
    "email_id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "email": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "rcpt_to": "ada@example.com",
      "mail_from": "Acme <news@acme.com>",
      "subject": "What's new in October",
      "created_at": "2026-10-01T10:02:11.583000+00:00",
      "campaign": {
        "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
        "name": "October product update"
      },
      "meta": null
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com"
    },
    "ip_address": "203.0.113.42",
    "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",
    "created_at": "2026-10-01T10:02:14.307000+00:00"
  },
  "data": {
    "object": {
      "id": "load_2xLg2Cw7Sr4Xo9Ud1Zn6Ke3Lt8g",
      "object": "load",
      "email_id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "email": {
        "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
        "rcpt_to": "ada@example.com",
        "mail_from": "Acme <news@acme.com>",
        "subject": "What's new in October",
        "created_at": "2026-10-01T10:02:11.583000+00:00",
        "campaign": {
          "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
          "name": "October product update"
        },
        "meta": null
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com"
      },
      "ip_address": "203.0.113.42",
      "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 17_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148",
      "created_at": "2026-10-01T10:02:14.307000+00:00"
    }
  }
}

email.clicked

Inviato ogni volta che qualcuno fa clic su un link tracciato in un’email. Il tracciamento dei clic richiede un dominio di tracciamento verificato e il tracciamento dei clic attivo per l’email. Emailit non filtra i clic automatici, come i controlli dei link eseguiti dagli scanner di sicurezza.

Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.

Campi

event_idstring

ID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.

typestring

Sempre email.clicked.

objectobject

Il clic descritto dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto clic

idstring

ID del clic (click_…).

objectstring

Sempre click.

email_idstring

ID dell’email (em_…).

emailobject

L’email.

email.idstring

ID dell’email (em_…).

email.rcpt_tostring

Indirizzo del destinatario.

email.mail_fromstring

Mittente così come è salvato nell’email. Può includere un nome visualizzato.

email.subjectstring | null

Riga dell’oggetto.

email.created_atstring

Quando Emailit ha accettato l’email.

email.campaignobject | null

id e name della campagna che ha inviato l’email, oppure null per le email inviate tramite API o SMTP.

email.metaobject | null

L’oggetto meta inviato con l’email, oppure null.

linkobject

Il link cliccato.

link.idstring

ID del link (link_…).

link.urlstring

URL di destinazione.

contactobject | null

id e email del contatto che ha l’indirizzo del destinatario in questo workspace, oppure null se non esiste.

ip_addressstring

Indirizzo IP della richiesta.

user_agentstring | null

User agent del client che ha inviato la richiesta.

created_atstring

Quando è avvenuto il clic, in formato ISO 8601 con offset UTC.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.clicked",
  "object": {
    "id": "click_2xLg1Bv6Rq3Wn8Tc0Ym5Jd2Ks7f",
    "object": "click",
    "email_id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "email": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "rcpt_to": "ada@example.com",
      "mail_from": "Acme <news@acme.com>",
      "subject": "What's new in October",
      "created_at": "2026-10-01T10:02:11.583000+00:00",
      "campaign": {
        "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
        "name": "October product update"
      },
      "meta": null
    },
    "link": {
      "id": "link_2xLf9Pa4Vt1Qm6Xs3Hc8Nb0Rd5e",
      "url": "https://acme.com/blog/october-update"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com"
    },
    "ip_address": "203.0.113.42",
    "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Safari/605.1.15",
    "created_at": "2026-10-01T10:02:14.307000+00:00"
  },
  "data": {
    "object": {
      "id": "click_2xLg1Bv6Rq3Wn8Tc0Ym5Jd2Ks7f",
      "object": "click",
      "email_id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "email": {
        "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
        "rcpt_to": "ada@example.com",
        "mail_from": "Acme <news@acme.com>",
        "subject": "What's new in October",
        "created_at": "2026-10-01T10:02:11.583000+00:00",
        "campaign": {
          "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
          "name": "October product update"
        },
        "meta": null
      },
      "link": {
        "id": "link_2xLf9Pa4Vt1Qm6Xs3Hc8Nb0Rd5e",
        "url": "https://acme.com/blog/october-update"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com"
      },
      "ip_address": "203.0.113.42",
      "user_agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/17.5 Safari/605.1.15",
      "created_at": "2026-10-01T10:02:14.307000+00:00"
    }
  }
}

email.unsubscribed

Inviato quando un contatto si disiscrive dalle tue campagne, ad esempio con il link di disiscrizione in un’email di una campagna. Emailit invia anche subscriber.updated per ogni lista che il contatto ha lasciato. Vedi Disiscrizioni.

Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.

Campi

event_idstring

ID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.

typestring

Sempre email.unsubscribed.

objectobject

L’email della campagna descritta dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto email

idstring | null

ID (em_…) dell’email della campagna su cui il contatto ha agito, oppure null se Emailit non è riuscito ad associarne una.

objectstring

Sempre email.

fromstring

Mittente dell’email della campagna.

tostring

L’indirizzo del contatto.

subjectstring

Riga dell’oggetto dell’email della campagna.

campaignobject | null

id e name della campagna, oppure null.

contactobject | null

id e email del contatto.

unsubscribed_atstring

Quando il contatto si è disiscritto, in formato ISO 8601 con offset UTC.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.unsubscribed",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "news@acme.com",
    "to": "ada@example.com",
    "subject": "What's new in October",
    "campaign": {
      "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
      "name": "October product update"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com"
    },
    "unsubscribed_at": "2026-10-01T10:02:14.307000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "news@acme.com",
      "to": "ada@example.com",
      "subject": "What's new in October",
      "campaign": {
        "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
        "name": "October product update"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com"
      },
      "unsubscribed_at": "2026-10-01T10:02:14.307000+00:00"
    }
  }
}

email.resubscribed

Inviato quando un contatto che si era disiscritto dalle tue campagne viene iscritto di nuovo, ad esempio con l’opzione di reiscrizione nella pagina di disiscrizione. Emailit invia anche subscriber.updated per ogni lista in cui il contatto è rientrato.

Le richieste webhook contengono un array JSON di eventi come questo; vedi Richieste webhook.

Campi

event_idstring

ID dell’evento (evt_…). Una richiesta ritentata contiene lo stesso ID: usalo per saltare gli eventi che hai già gestito. Puoi anche consultare l’evento con Recupera un evento.

typestring

Sempre email.resubscribed.

objectobject

L’email della campagna descritta dall’evento. I suoi campi sono elencati qui sotto.

data.objectobject

Di nuovo lo stesso oggetto, nella forma in cui l’API degli eventi lo restituisce in data.

Oggetto email

idstring | null

ID (em_…) dell’email della campagna su cui il contatto ha agito, oppure null se Emailit non è riuscito ad associarne una.

objectstring

Sempre email.

fromstring

Mittente dell’email della campagna.

tostring

L’indirizzo del contatto.

subjectstring

Riga dell’oggetto dell’email della campagna.

campaignobject | null

id e name della campagna, oppure null.

contactobject | null

id e email del contatto.

resubscribed_atstring

Quando il contatto si è reiscritto, in formato ISO 8601 con offset UTC.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "email.resubscribed",
  "object": {
    "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
    "object": "email",
    "from": "news@acme.com",
    "to": "ada@example.com",
    "subject": "What's new in October",
    "campaign": {
      "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
      "name": "October product update"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com"
    },
    "resubscribed_at": "2026-10-01T10:02:14.307000+00:00"
  },
  "data": {
    "object": {
      "id": "em_2xLc8Mm3Pq5Vn0Ra7Jt2Wd9Fb4e",
      "object": "email",
      "from": "news@acme.com",
      "to": "ada@example.com",
      "subject": "What's new in October",
      "campaign": {
        "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
        "name": "October product update"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com"
      },
      "resubscribed_at": "2026-10-01T10:02:14.307000+00:00"
    }
  }
}