Eventi delle liste

Liste create, aggiornate o eliminate.

audience.created
audience.updated
audience.deleted

audience.created

Inviato quando viene creata una lista, ad esempio con Crea una lista.

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

objectobject

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

idstring

ID della lista (aud_…).

objectstring

Sempre audience.

namestring

Nome della lista.

created_atstring

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

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "audience.created",
  "object": {
    "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
    "object": "audience",
    "name": "Newsletter",
    "created_at": "2026-10-01T10:02:11.583000+00:00"
  },
  "data": {
    "object": {
      "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
      "object": "audience",
      "name": "Newsletter",
      "created_at": "2026-10-01T10:02:11.583000+00:00"
    }
  }
}

audience.updated

Inviato quando una lista cambia, ad esempio quando la rinomini con Aggiorna una lista. Le modifiche agli iscritti generano invece gli eventi degli iscritti.

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

objectobject

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

idstring

ID della lista (aud_…).

objectstring

Sempre audience.

namestring

Nome della lista.

updated_atstring

Quando è stata aggiornata l’ultima volta la lista, in formato ISO 8601 con offset UTC.

created_atstring

Quando è stata creata la lista.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "audience.updated",
  "object": {
    "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
    "object": "audience",
    "name": "Monthly newsletter",
    "updated_at": "2026-10-01T10:02:14.307000+00:00",
    "created_at": "2026-09-15T12:00:41.305000+00:00"
  },
  "data": {
    "object": {
      "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
      "object": "audience",
      "name": "Monthly newsletter",
      "updated_at": "2026-10-01T10:02:14.307000+00:00",
      "created_at": "2026-09-15T12:00:41.305000+00:00"
    }
  }
}

audience.deleted

Inviato quando viene eliminata una lista, ad esempio con Elimina una lista. Il payload è la lista 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 audience.deleted.

objectobject

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

idstring

ID della lista (aud_…).

objectstring

Sempre audience.

namestring

Nome della lista.

updated_atstring

Quando è stata aggiornata l’ultima volta la lista, in formato ISO 8601 con offset UTC.

created_atstring

Quando è stata creata la lista.

JSON

{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "audience.deleted",
  "object": {
    "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
    "object": "audience",
    "name": "Monthly newsletter",
    "updated_at": "2026-09-30T08:14:02.771000+00:00",
    "created_at": "2026-09-15T12:00:41.305000+00:00"
  },
  "data": {
    "object": {
      "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
      "object": "audience",
      "name": "Monthly newsletter",
      "updated_at": "2026-09-30T08:14:02.771000+00:00",
      "created_at": "2026-09-15T12:00:41.305000+00:00"
    }
  }
}