Eventi delle campagne

Campagne create, modificate, programmate, inviate, annullate, archiviate o eliminate.

campaign.created
campaign.updated
campaign.scheduled
campaign.queued
campaign.sending
campaign.sent
campaign.canceled
campaign.archived
campaign.deleted

campaign.created

Inviato quando viene creata una campagna con Crea una campagna o nel pannello, anche quando duplichi una campagna. Le nuove campagne partono nello stato draft.

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 campaign.created.

objectobject

La 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 campagna

idstring

ID della campagna (cmp_…).

objectstring

Sempre campaign.

namestring

Nome della campagna.

statusstring

Sempre draft.

subjectstring

Riga dell’oggetto, oppure una stringa vuota se non è ancora impostata.

from_emailstring

Indirizzo del mittente, oppure una stringa vuota.

from_namestring

Nome del mittente, oppure una stringa vuota.

scheduled_atstring | null

Quando è programmato l’invio della campagna, oppure null.

sent_atstring | null

Quando è stata inviata la campagna, oppure null.

created_atstring

Quando è stata creata la campagna, in formato ISO 8601 con offset UTC.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "campaign.created",
  "object": {
    "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
    "object": "campaign",
    "name": "October product update",
    "status": "draft",
    "subject": "What's new in October",
    "from_email": "news@acme.com",
    "from_name": "Acme",
    "scheduled_at": null,
    "sent_at": null,
    "created_at": "2026-09-29T15:10:44.031000+00:00"
  },
  "data": {
    "object": {
      "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
      "object": "campaign",
      "name": "October product update",
      "status": "draft",
      "subject": "What's new in October",
      "from_email": "news@acme.com",
      "from_name": "Acme",
      "scheduled_at": null,
      "sent_at": null,
      "created_at": "2026-09-29T15:10:44.031000+00:00"
    }
  }
}

campaign.updated

Inviato quando cambiano il contenuto o le impostazioni di una campagna, ad esempio con Aggiorna una campagna, oppure quando torna a draft perché ne hai annullato la programmazione o l’hai tolta dall’archivio nel pannello. Se lo stato è cambiato, previous_status contiene lo stato precedente.

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 campaign.updated.

objectobject

La 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 campagna

idstring

ID della campagna (cmp_…).

objectstring

Sempre campaign.

namestring

Nome della campagna.

statusstring

Stato attuale: draft, scheduled, queued, sending, sent, canceled o archived.

subjectstring

Riga dell’oggetto, oppure una stringa vuota se non è ancora impostata.

from_emailstring

Indirizzo del mittente, oppure una stringa vuota.

from_namestring

Nome del mittente, oppure una stringa vuota.

scheduled_atstring | null

Quando è programmato l’invio della campagna, oppure null.

sent_atstring | null

Quando è stata inviata la campagna, oppure null.

created_atstring

Quando è stata creata la campagna, in formato ISO 8601 con offset UTC.

previous_statusstring

Stato prima della modifica. Incluso solo se lo stato è cambiato.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "campaign.updated",
  "object": {
    "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
    "object": "campaign",
    "name": "October product update",
    "status": "draft",
    "subject": "What's new in October",
    "from_email": "news@acme.com",
    "from_name": "Acme",
    "scheduled_at": null,
    "sent_at": null,
    "created_at": "2026-09-29T15:10:44.031000+00:00",
    "previous_status": "scheduled"
  },
  "data": {
    "object": {
      "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
      "object": "campaign",
      "name": "October product update",
      "status": "draft",
      "subject": "What's new in October",
      "from_email": "news@acme.com",
      "from_name": "Acme",
      "scheduled_at": null,
      "sent_at": null,
      "created_at": "2026-09-29T15:10:44.031000+00:00",
      "previous_status": "scheduled"
    }
  }
}

campaign.scheduled

Inviato quando programmi una campagna in bozza con Invia o programma una campagna e un scheduled_at nel futuro, oppure nel pannello. Vedi Testa e programma.

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 campaign.scheduled.

objectobject

La 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 campagna

idstring

ID della campagna (cmp_…).

objectstring

Sempre campaign.

namestring

Nome della campagna.

statusstring

Sempre scheduled.

subjectstring

Riga dell’oggetto, oppure una stringa vuota se non è ancora impostata.

from_emailstring

Indirizzo del mittente, oppure una stringa vuota.

from_namestring

Nome del mittente, oppure una stringa vuota.

scheduled_atstring | null

Quando è programmato l’invio della campagna, oppure null.

sent_atstring | null

Quando è stata inviata la campagna, oppure null.

created_atstring

Quando è stata creata la campagna, in formato ISO 8601 con offset UTC.

previous_statusstring

Stato prima della modifica, di solito draft.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "campaign.scheduled",
  "object": {
    "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
    "object": "campaign",
    "name": "October product update",
    "status": "scheduled",
    "subject": "What's new in October",
    "from_email": "news@acme.com",
    "from_name": "Acme",
    "scheduled_at": "2026-10-02T08:00:00.000000+00:00",
    "sent_at": null,
    "created_at": "2026-09-29T15:10:44.031000+00:00",
    "previous_status": "draft"
  },
  "data": {
    "object": {
      "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
      "object": "campaign",
      "name": "October product update",
      "status": "scheduled",
      "subject": "What's new in October",
      "from_email": "news@acme.com",
      "from_name": "Acme",
      "scheduled_at": "2026-10-02T08:00:00.000000+00:00",
      "sent_at": null,
      "created_at": "2026-09-29T15:10:44.031000+00:00",
      "previous_status": "draft"
    }
  }
}

campaign.queued

Inviato quando arriva l’orario di invio di una campagna programmata ed Emailit la mette in coda. Quando inizia l’invio segue campaign.sending.

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 campaign.queued.

objectobject

La 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 campagna

idstring

ID della campagna (cmp_…).

objectstring

Sempre campaign.

namestring

Nome della campagna.

statusstring

Sempre queued.

subjectstring

Riga dell’oggetto, oppure una stringa vuota se non è ancora impostata.

from_emailstring

Indirizzo del mittente, oppure una stringa vuota.

from_namestring

Nome del mittente, oppure una stringa vuota.

scheduled_atstring | null

Quando è programmato l’invio della campagna, oppure null.

sent_atstring | null

Quando è stata inviata la campagna, oppure null.

created_atstring

Quando è stata creata la campagna, in formato ISO 8601 con offset UTC.

previous_statusstring

Sempre scheduled.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "campaign.queued",
  "object": {
    "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
    "object": "campaign",
    "name": "October product update",
    "status": "queued",
    "subject": "What's new in October",
    "from_email": "news@acme.com",
    "from_name": "Acme",
    "scheduled_at": "2026-10-02T08:00:00.000000+00:00",
    "sent_at": null,
    "created_at": "2026-09-29T15:10:44.031000+00:00",
    "previous_status": "scheduled"
  },
  "data": {
    "object": {
      "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
      "object": "campaign",
      "name": "October product update",
      "status": "queued",
      "subject": "What's new in October",
      "from_email": "news@acme.com",
      "from_name": "Acme",
      "scheduled_at": "2026-10-02T08:00:00.000000+00:00",
      "sent_at": null,
      "created_at": "2026-09-29T15:10:44.031000+00:00",
      "previous_status": "scheduled"
    }
  }
}

campaign.sending

Inviato quando Emailit inizia a inviare una campagna: subito, quando la invii con Invia o programma una campagna o dal pannello, oppure quando parte una campagna programmata già in coda.

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 campaign.sending.

objectobject

La 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 campagna

idstring

ID della campagna (cmp_…).

objectstring

Sempre campaign.

namestring

Nome della campagna.

statusstring

Sempre sending.

subjectstring

Riga dell’oggetto, oppure una stringa vuota se non è ancora impostata.

from_emailstring

Indirizzo del mittente, oppure una stringa vuota.

from_namestring

Nome del mittente, oppure una stringa vuota.

scheduled_atstring | null

Quando è programmato l’invio della campagna, oppure null.

sent_atstring | null

Quando è stata inviata la campagna, oppure null.

created_atstring

Quando è stata creata la campagna, in formato ISO 8601 con offset UTC.

previous_statusstring

draft se hai inviato la campagna subito, queued per una campagna programmata.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "campaign.sending",
  "object": {
    "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
    "object": "campaign",
    "name": "October product update",
    "status": "sending",
    "subject": "What's new in October",
    "from_email": "news@acme.com",
    "from_name": "Acme",
    "scheduled_at": null,
    "sent_at": "2026-10-01T10:00:03.214000+00:00",
    "created_at": "2026-09-29T15:10:44.031000+00:00",
    "previous_status": "draft"
  },
  "data": {
    "object": {
      "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
      "object": "campaign",
      "name": "October product update",
      "status": "sending",
      "subject": "What's new in October",
      "from_email": "news@acme.com",
      "from_name": "Acme",
      "scheduled_at": null,
      "sent_at": "2026-10-01T10:00:03.214000+00:00",
      "created_at": "2026-09-29T15:10:44.031000+00:00",
      "previous_status": "draft"
    }
  }
}

campaign.sent

Inviato quando Emailit ha creato e messo in coda un’email per ogni destinatario iscritto della campagna. Gli eventi di consegna, apertura e clic delle singole email seguono man mano che si verificano. Vedi Report delle campagne.

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 campaign.sent.

objectobject

La 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 campagna

idstring

ID della campagna (cmp_…).

objectstring

Sempre campaign.

namestring

Nome della campagna.

statusstring

Sempre sent.

subjectstring

Riga dell’oggetto, oppure una stringa vuota se non è ancora impostata.

from_emailstring

Indirizzo del mittente, oppure una stringa vuota.

from_namestring

Nome del mittente, oppure una stringa vuota.

scheduled_atstring | null

Quando è programmato l’invio della campagna, oppure null.

sent_atstring | null

Quando è stata inviata la campagna, oppure null.

created_atstring

Quando è stata creata la campagna, in formato ISO 8601 con offset UTC.

previous_statusstring

Sempre sending.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "campaign.sent",
  "object": {
    "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
    "object": "campaign",
    "name": "October product update",
    "status": "sent",
    "subject": "What's new in October",
    "from_email": "news@acme.com",
    "from_name": "Acme",
    "scheduled_at": null,
    "sent_at": "2026-10-01T10:04:51.000000+00:00",
    "created_at": "2026-09-29T15:10:44.031000+00:00",
    "previous_status": "sending"
  },
  "data": {
    "object": {
      "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
      "object": "campaign",
      "name": "October product update",
      "status": "sent",
      "subject": "What's new in October",
      "from_email": "news@acme.com",
      "from_name": "Acme",
      "scheduled_at": null,
      "sent_at": "2026-10-01T10:04:51.000000+00:00",
      "created_at": "2026-09-29T15:10:44.031000+00:00",
      "previous_status": "sending"
    }
  }
}

campaign.canceled

Inviato quando annulli una campagna con Annulla una campagna. Si possono annullare solo le campagne draft e sending.

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 campaign.canceled.

objectobject

La 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 campagna

idstring

ID della campagna (cmp_…).

objectstring

Sempre campaign.

namestring

Nome della campagna.

statusstring

Sempre canceled.

subjectstring

Riga dell’oggetto, oppure una stringa vuota se non è ancora impostata.

from_emailstring

Indirizzo del mittente, oppure una stringa vuota.

from_namestring

Nome del mittente, oppure una stringa vuota.

scheduled_atstring | null

Quando è programmato l’invio della campagna, oppure null.

sent_atstring | null

Quando è stata inviata la campagna, oppure null.

created_atstring

Quando è stata creata la campagna, in formato ISO 8601 con offset UTC.

previous_statusstring

draft o sending.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "campaign.canceled",
  "object": {
    "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
    "object": "campaign",
    "name": "October product update",
    "status": "canceled",
    "subject": "What's new in October",
    "from_email": "news@acme.com",
    "from_name": "Acme",
    "scheduled_at": null,
    "sent_at": null,
    "created_at": "2026-09-29T15:10:44.031000+00:00",
    "previous_status": "draft"
  },
  "data": {
    "object": {
      "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
      "object": "campaign",
      "name": "October product update",
      "status": "canceled",
      "subject": "What's new in October",
      "from_email": "news@acme.com",
      "from_name": "Acme",
      "scheduled_at": null,
      "sent_at": null,
      "created_at": "2026-09-29T15:10:44.031000+00:00",
      "previous_status": "draft"
    }
  }
}

campaign.archived

Inviato quando archivi una campagna inviata nel pannello. Se la togli dall’archivio, la campagna torna a draft e viene inviato campaign.updated con previous_status impostato su archived.

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 campaign.archived.

objectobject

La 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 campagna

idstring

ID della campagna (cmp_…).

objectstring

Sempre campaign.

namestring

Nome della campagna.

statusstring

Sempre archived.

subjectstring

Riga dell’oggetto, oppure una stringa vuota se non è ancora impostata.

from_emailstring

Indirizzo del mittente, oppure una stringa vuota.

from_namestring

Nome del mittente, oppure una stringa vuota.

scheduled_atstring | null

Quando è programmato l’invio della campagna, oppure null.

sent_atstring | null

Quando è stata inviata la campagna, oppure null.

created_atstring

Quando è stata creata la campagna, in formato ISO 8601 con offset UTC.

previous_statusstring

Sempre sent.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "campaign.archived",
  "object": {
    "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
    "object": "campaign",
    "name": "October product update",
    "status": "archived",
    "subject": "What's new in October",
    "from_email": "news@acme.com",
    "from_name": "Acme",
    "scheduled_at": null,
    "sent_at": "2026-10-01T10:04:51.000000+00:00",
    "created_at": "2026-09-29T15:10:44.031000+00:00",
    "previous_status": "sent"
  },
  "data": {
    "object": {
      "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
      "object": "campaign",
      "name": "October product update",
      "status": "archived",
      "subject": "What's new in October",
      "from_email": "news@acme.com",
      "from_name": "Acme",
      "scheduled_at": null,
      "sent_at": "2026-10-01T10:04:51.000000+00:00",
      "created_at": "2026-09-29T15:10:44.031000+00:00",
      "previous_status": "sent"
    }
  }
}

campaign.deleted

Inviato quando viene eliminata una campagna con Elimina una campagna o nel pannello. Il payload è la campagna com’era prima di essere eliminata.

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 campaign.deleted.

objectobject

La 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 campagna

idstring

ID della campagna (cmp_…).

objectstring

Sempre campaign.

namestring

Nome della campagna.

statusstring

Stato della campagna al momento dell’eliminazione.

subjectstring

Riga dell’oggetto, oppure una stringa vuota se non è ancora impostata.

from_emailstring

Indirizzo del mittente, oppure una stringa vuota.

from_namestring

Nome del mittente, oppure una stringa vuota.

scheduled_atstring | null

Quando è programmato l’invio della campagna, oppure null.

sent_atstring | null

Quando è stata inviata la campagna, oppure null.

created_atstring

Quando è stata creata la campagna, in formato ISO 8601 con offset UTC.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "campaign.deleted",
  "object": {
    "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
    "object": "campaign",
    "name": "October product update",
    "status": "draft",
    "subject": "What's new in October",
    "from_email": "news@acme.com",
    "from_name": "Acme",
    "scheduled_at": null,
    "sent_at": null,
    "created_at": "2026-09-29T15:10:44.031000+00:00"
  },
  "data": {
    "object": {
      "id": "cmp_2xLf3Gd8Wr5Mb0Tq6Yn1Kc4Hs9e",
      "object": "campaign",
      "name": "October product update",
      "status": "draft",
      "subject": "What's new in October",
      "from_email": "news@acme.com",
      "from_name": "Acme",
      "scheduled_at": null,
      "sent_at": null,
      "created_at": "2026-09-29T15:10:44.031000+00:00"
    }
  }
}