# 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 tramite l’API, il pannello o un contatto creato con delle liste. # subscriber.created Inviato quando un contatto viene aggiunto a una lista con [Aggiungi un iscritto](/it/docs/api-reference/audiences/subscribers/add/), oppure quando crei o aggiorni un contatto con `audiences`. Se aggiungi un contatto che si era disiscritto dalla lista, vengono invece inviati [`subscriber.updated`](/it/docs/webhooks/events/subscriber/updated/) e [`subscriber.resubscribed`](/it/docs/webhooks/events/subscriber/resubscribed/). Le richieste webhook contengono un array JSON di eventi come questo; vedi [Richieste webhook](/it/docs/webhooks/webhook-requests/). ```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" } } } ``` ## Campi - `event_id` (string): 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](/it/docs/api-reference/events/get/). - `type` (string): Sempre `subscriber.created`. - `object` (object): L’iscritto descritto dall’evento. I suoi campi sono elencati qui sotto. - `data.object` (object): Di nuovo lo stesso oggetto, nella forma in cui l’[API degli eventi](/it/docs/api-reference/events/get/) lo restituisce in `data`. ### Oggetto iscritto - `id` (string): ID dell’iscritto (`sub_…`). Un iscritto è l’appartenenza di un contatto a una lista. - `object` (string): Sempre `subscriber`. - `subscribed` (boolean): Indica se il contatto è iscritto alla lista. - `subscribed_at` (string | null): Quando il contatto si è iscritto, oppure `null`. - `unsubscribed_at` (string | null): Quando il contatto si è disiscritto, oppure `null`. - `audience` (object): `id` e `name` della lista. - `contact` (object): Il contatto: `id`, `email`, `first_name`, `last_name` e `custom_fields`. - `created_at` (string): Quando il contatto è stato aggiunto alla lista, in formato ISO 8601 con offset UTC. --- Fonte: https://emailit.com/it/docs/webhooks/events/subscriber/subscriber-created/ ## subscriber.updated > Inviato quando un iscritto cambia, anche quando il contatto si disiscrive da una lista o vi rientra. # subscriber.updated Inviato quando un iscritto cambia: lo aggiorni con [Aggiorna un iscritto](/it/docs/api-reference/audiences/subscribers/update/), 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](/it/docs/webhooks/webhook-requests/). ```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 } } } } ``` ## Campi - `event_id` (string): 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](/it/docs/api-reference/events/get/). - `type` (string): Sempre `subscriber.updated`. - `object` (object): L’iscritto descritto dall’evento. I suoi campi sono elencati qui sotto. - `data.object` (object): Di nuovo lo stesso oggetto, nella forma in cui l’[API degli eventi](/it/docs/api-reference/events/get/) lo restituisce in `data`. ### Oggetto iscritto - `id` (string): ID dell’iscritto (`sub_…`). Un iscritto è l’appartenenza di un contatto a una lista. - `object` (string): Sempre `subscriber`. - `subscribed` (boolean): Indica se il contatto è iscritto alla lista. - `subscribed_at` (string | null): Quando il contatto si è iscritto, oppure `null`. - `unsubscribed_at` (string | null): Quando il contatto si è disiscritto, oppure `null`. - `audience` (object): `id` e `name` della lista. - `contact` (object): Il contatto: `id`, `email`, `first_name`, `last_name` e `custom_fields`. - `updated_at` (string): Quando è stato aggiornato l’ultima volta l’iscritto, in formato ISO 8601 con offset UTC. - `created_at` (string): Quando il contatto è stato aggiunto alla lista. - `previous` (object): Valori precedenti, inclusi quando il contatto si è disiscritto o reiscritto: `subscribed` e `unsubscribed_at`. Omesso per le altre modifiche. --- Fonte: https://emailit.com/it/docs/webhooks/events/subscriber/subscriber-updated/ ## subscriber.resubscribed > Inviato quando aggiungi di nuovo un contatto a una lista da cui si era disiscritto. Non fa parte dell’elenco degli eventi del pannello. # subscriber.resubscribed Inviato quando aggiungi un contatto a una lista da cui si era disiscritto, con [Aggiungi un iscritto](/it/docs/api-reference/audiences/subscribers/add/). Emailit invia anche [`subscriber.updated`](/it/docs/webhooks/events/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](/it/docs/api-reference/webhooks/update/). Le richieste webhook contengono un array JSON di eventi come questo; vedi [Richieste webhook](/it/docs/webhooks/webhook-requests/). ```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 } } } ``` ## Campi - `event_id` (string): 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](/it/docs/api-reference/events/get/). - `type` (string): Sempre `subscriber.resubscribed`. - `object` (object): L’iscritto descritto dall’evento. I suoi campi sono elencati qui sotto. - `data.object` (object): Di nuovo lo stesso oggetto, nella forma in cui l’[API degli eventi](/it/docs/api-reference/events/get/) lo restituisce in `data`. ### Oggetto iscritto - `id` (string): ID dell’iscritto (`sub_…`). Un iscritto è l’appartenenza di un contatto a una lista. - `object` (string): Sempre `subscriber`. - `subscribed` (boolean): Indica se il contatto è iscritto alla lista. - `subscribed_at` (string | null): Quando il contatto si è iscritto, oppure `null`. - `unsubscribed_at` (string | null): Quando il contatto si è disiscritto, oppure `null`. - `audience` (object): `id` e `name` della lista. - `contact` (object): Il contatto: `id`, `email`, `first_name`, `last_name` e `custom_fields`. - `updated_at` (string): Quando è stato aggiornato l’ultima volta l’iscritto, in formato ISO 8601 con offset UTC. - `created_at` (string): Quando il contatto è stato aggiunto alla lista. - `resubscribed` (boolean): Sempre `true`. --- Fonte: https://emailit.com/it/docs/webhooks/events/subscriber/subscriber-resubscribed/ ## subscriber.deleted > Inviato quando un contatto viene rimosso da una lista, anche quando viene eliminato il contatto stesso. # subscriber.deleted Inviato quando un contatto viene rimosso da una lista: con [Elimina un iscritto](/it/docs/api-reference/audiences/subscribers/delete/), 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](/it/docs/webhooks/webhook-requests/). ```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" } } } ``` ## Campi - `event_id` (string): 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](/it/docs/api-reference/events/get/). - `type` (string): Sempre `subscriber.deleted`. - `object` (object): L’iscritto descritto dall’evento. I suoi campi sono elencati qui sotto. - `data.object` (object): Di nuovo lo stesso oggetto, nella forma in cui l’[API degli eventi](/it/docs/api-reference/events/get/) lo restituisce in `data`. ### Oggetto iscritto - `id` (string): ID dell’iscritto (`sub_…`). Un iscritto è l’appartenenza di un contatto a una lista. - `object` (string): Sempre `subscriber`. - `subscribed` (boolean): Indica se il contatto è iscritto alla lista. - `subscribed_at` (string | null): Quando il contatto si è iscritto, oppure `null`. - `unsubscribed_at` (string | null): Quando il contatto si è disiscritto, oppure `null`. - `audience` (object): `id` e `name` della lista. - `contact` (object): Il contatto: `id`, `email`, `first_name`, `last_name` e `custom_fields`. - `updated_at` (string): Quando è stato aggiornato l’ultima volta l’iscritto, in formato ISO 8601 con offset UTC. - `created_at` (string): Quando il contatto è stato aggiunto alla lista. --- Fonte: https://emailit.com/it/docs/webhooks/events/subscriber/subscriber-deleted/