Vai al contenuto
Docs

Eventi degli iscritti

Contatti aggiunti a una lista, modificati, aggiunti di nuovo o rimossi.

subscriber.created

Inviato quando un contatto viene aggiunto a una lista con Aggiungi un iscritto, oppure quando crei o aggiorni un contatto con audiences. Se aggiungi un contatto che si era disiscritto dalla lista, vengono invece inviati subscriber.updated e subscriber.resubscribed.

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

objectobject

L’iscritto 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 iscritto

idstring

ID dell’iscritto (sub_…). Un iscritto è l’appartenenza di un contatto a una lista.

objectstring

Sempre subscriber.

subscribedboolean

Indica se il contatto è iscritto alla lista.

subscribed_atstring | null

Quando il contatto si è iscritto, oppure null.

unsubscribed_atstring | null

Quando il contatto si è disiscritto, oppure null.

audienceobject

id e name della lista.

contactobject

Il contatto: id, email, first_name, last_name e custom_fields.

created_atstring

Quando il contatto è stato aggiunto alla lista, in formato ISO 8601 con offset UTC.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "subscriber.created",
  "object": {
    "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
    "object": "subscriber",
    "subscribed": true,
    "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
    "unsubscribed_at": null,
    "audience": {
      "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
      "name": "Newsletter"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "company": "Analytical Engines"
      }
    },
    "created_at": "2026-09-20T14:22:09.418302+00:00"
  },
  "data": {
    "object": {
      "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
      "object": "subscriber",
      "subscribed": true,
      "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
      "unsubscribed_at": null,
      "audience": {
        "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
        "name": "Newsletter"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "custom_fields": {
          "company": "Analytical Engines"
        }
      },
      "created_at": "2026-09-20T14:22:09.418302+00:00"
    }
  }
}

subscriber.updated

Inviato quando un iscritto cambia: lo aggiorni con Aggiorna un iscritto, il contatto si disiscrive o si reiscrive, oppure un contatto che si era disiscritto viene aggiunto di nuovo alla lista. Quando la modifica deriva da una disiscrizione o da una reiscrizione, previous contiene i valori precedenti.

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

objectobject

L’iscritto 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 iscritto

idstring

ID dell’iscritto (sub_…). Un iscritto è l’appartenenza di un contatto a una lista.

objectstring

Sempre subscriber.

subscribedboolean

Indica se il contatto è iscritto alla lista.

subscribed_atstring | null

Quando il contatto si è iscritto, oppure null.

unsubscribed_atstring | null

Quando il contatto si è disiscritto, oppure null.

audienceobject

id e name della lista.

contactobject

Il contatto: id, email, first_name, last_name e custom_fields.

updated_atstring

Quando è stato aggiornato l’ultima volta l’iscritto, in formato ISO 8601 con offset UTC.

created_atstring

Quando il contatto è stato aggiunto alla lista.

previousobject

Valori precedenti, inclusi quando il contatto si è disiscritto o reiscritto: subscribed e unsubscribed_at. Omesso per le altre modifiche.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "subscriber.updated",
  "object": {
    "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
    "object": "subscriber",
    "subscribed": false,
    "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
    "unsubscribed_at": "2026-10-01T10:02:14.000000+00:00",
    "audience": {
      "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
      "name": "Newsletter"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "company": "Analytical Engines"
      }
    },
    "updated_at": "2026-10-01T10:02:14.307000+00:00",
    "created_at": "2026-09-20T14:22:09.418302+00:00",
    "previous": {
      "subscribed": true,
      "unsubscribed_at": null
    }
  },
  "data": {
    "object": {
      "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
      "object": "subscriber",
      "subscribed": false,
      "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
      "unsubscribed_at": "2026-10-01T10:02:14.000000+00:00",
      "audience": {
        "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
        "name": "Newsletter"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "custom_fields": {
          "company": "Analytical Engines"
        }
      },
      "updated_at": "2026-10-01T10:02:14.307000+00:00",
      "created_at": "2026-09-20T14:22:09.418302+00:00",
      "previous": {
        "subscribed": true,
        "unsubscribed_at": null
      }
    }
  }
}

subscriber.resubscribed

Inviato quando aggiungi un contatto a una lista da cui si era disiscritto, con Aggiungi un iscritto. Emailit invia anche subscriber.updated con lo stesso iscritto.

subscriber.resubscribed 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 subscriber.resubscribed.

objectobject

L’iscritto 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 iscritto

idstring

ID dell’iscritto (sub_…). Un iscritto è l’appartenenza di un contatto a una lista.

objectstring

Sempre subscriber.

subscribedboolean

Indica se il contatto è iscritto alla lista.

subscribed_atstring | null

Quando il contatto si è iscritto, oppure null.

unsubscribed_atstring | null

Quando il contatto si è disiscritto, oppure null.

audienceobject

id e name della lista.

contactobject

Il contatto: id, email, first_name, last_name e custom_fields.

updated_atstring

Quando è stato aggiornato l’ultima volta l’iscritto, in formato ISO 8601 con offset UTC.

created_atstring

Quando il contatto è stato aggiunto alla lista.

resubscribedboolean

Sempre true.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "subscriber.resubscribed",
  "object": {
    "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
    "object": "subscriber",
    "subscribed": true,
    "subscribed_at": "2026-10-01T10:02:14.307000+00:00",
    "unsubscribed_at": null,
    "audience": {
      "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
      "name": "Newsletter"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "company": "Analytical Engines"
      }
    },
    "updated_at": "2026-10-01T10:02:14.307000+00:00",
    "created_at": "2026-09-20T14:22:09.418302+00:00",
    "resubscribed": true
  },
  "data": {
    "object": {
      "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
      "object": "subscriber",
      "subscribed": true,
      "subscribed_at": "2026-10-01T10:02:14.307000+00:00",
      "unsubscribed_at": null,
      "audience": {
        "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
        "name": "Newsletter"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "custom_fields": {
          "company": "Analytical Engines"
        }
      },
      "updated_at": "2026-10-01T10:02:14.307000+00:00",
      "created_at": "2026-09-20T14:22:09.418302+00:00",
      "resubscribed": true
    }
  }
}

subscriber.deleted

Inviato quando un contatto viene rimosso da una lista: con Elimina un iscritto, quando modifichi le audiences di un contatto o quando elimini il contatto. Il payload è l’iscritto com’era prima della rimozione.

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

objectobject

L’iscritto 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 iscritto

idstring

ID dell’iscritto (sub_…). Un iscritto è l’appartenenza di un contatto a una lista.

objectstring

Sempre subscriber.

subscribedboolean

Indica se il contatto è iscritto alla lista.

subscribed_atstring | null

Quando il contatto si è iscritto, oppure null.

unsubscribed_atstring | null

Quando il contatto si è disiscritto, oppure null.

audienceobject

id e name della lista.

contactobject

Il contatto: id, email, first_name, last_name e custom_fields.

updated_atstring

Quando è stato aggiornato l’ultima volta l’iscritto, in formato ISO 8601 con offset UTC.

created_atstring

Quando il contatto è stato aggiunto alla lista.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "subscriber.deleted",
  "object": {
    "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
    "object": "subscriber",
    "subscribed": true,
    "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
    "unsubscribed_at": null,
    "audience": {
      "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
      "name": "Newsletter"
    },
    "contact": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "company": "Analytical Engines"
      }
    },
    "updated_at": "2026-09-20T14:22:09.418302+00:00",
    "created_at": "2026-09-20T14:22:09.418302+00:00"
  },
  "data": {
    "object": {
      "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
      "object": "subscriber",
      "subscribed": true,
      "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
      "unsubscribed_at": null,
      "audience": {
        "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
        "name": "Newsletter"
      },
      "contact": {
        "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
        "email": "ada@example.com",
        "first_name": "Ada",
        "last_name": "Lovelace",
        "custom_fields": {
          "company": "Analytical Engines"
        }
      },
      "updated_at": "2026-09-20T14:22:09.418302+00:00",
      "created_at": "2026-09-20T14:22:09.418302+00:00"
    }
  }
}

Questa pagina ti è stata utile?

Grazie del feedback.

Grazie, leggiamo ogni messaggio.

Esc

Popolari

↑↓per spostarti↵per aprireEscper chiudere