Vai al contenuto
Docs

Contatti creati, aggiornati o eliminati.

contact.created

Inviato quando viene creato un contatto con Crea un contatto. Se passi audiences, Emailit invia anche subscriber.created per ogni 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 contact.created.

objectobject

Il contatto 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 contatto

idstring

ID del contatto (con_…).

objectstring

Sempre contact.

emailstring

Indirizzo del contatto, in minuscolo.

first_namestring | null

Nome.

last_namestring | null

Cognome.

custom_fieldsobject

Valori dei campi personalizzati, indicizzati per campo. Vedi Campi personalizzati.

unsubscribedboolean

Indica se il contatto è disiscritto da tutte le campagne.

created_atstring

Quando è stato creato il contatto, in formato ISO 8601 con offset UTC.

audiencesobject[]

Liste a cui appartiene il contatto. Ogni elemento contiene l’id della lista e un oggetto subscriber con id, subscribed, subscribed_at e unsubscribed_at.

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

contact.updated

Inviato quando un contatto cambia, con Aggiorna un contatto o con le azioni unsubscribe e resubscribe delle azioni di massa sui contatti. Le modifiche alle liste generano anche 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 contact.updated.

objectobject

Il contatto 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 contatto

idstring

ID del contatto (con_…).

objectstring

Sempre contact.

emailstring

Indirizzo del contatto, in minuscolo.

first_namestring | null

Nome.

last_namestring | null

Cognome.

custom_fieldsobject

Valori dei campi personalizzati, indicizzati per campo. Vedi Campi personalizzati.

unsubscribedboolean

Indica se il contatto è disiscritto da tutte le campagne.

updated_atstring

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

created_atstring

Quando è stato creato il contatto.

audiencesobject[]

Liste a cui appartiene il contatto. Ogni elemento contiene l’id della lista e un oggetto subscriber con id, subscribed, subscribed_at e unsubscribed_at.

previousobject

Valori precedenti dei campi modificati tra email, first_name, last_name, unsubscribed e custom_fields. Omesso se nessuno di questi campi è cambiato.

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

contact.deleted

Inviato quando viene eliminato un contatto con Elimina un contatto o con l’azione di massa delete. Prima Emailit invia subscriber.deleted per ogni lista a cui apparteneva il contatto.

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

objectobject

Il contatto 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 contatto

idstring

ID del contatto (con_…).

objectstring

Sempre contact.

emailstring

Indirizzo del contatto, in minuscolo.

first_namestring | null

Nome.

last_namestring | null

Cognome.

custom_fieldsobject

Valori dei campi personalizzati, indicizzati per campo. Vedi Campi personalizzati.

unsubscribedboolean

Indica se il contatto è disiscritto da tutte le campagne.

updated_atstring

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

created_atstring

Quando è stato creato il contatto.

audiencesobject[]

Liste a cui appartiene il contatto. Ogni elemento contiene l’id della lista e un oggetto subscriber con id, subscribed, subscribed_at e unsubscribed_at.

JSON
{
  "event_id": "evt_2xLc9Rr4Tn6Wb1Qm8Ks3Vf0Hd7a",
  "type": "contact.deleted",
  "object": {
    "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
    "object": "contact",
    "email": "ada@example.com",
    "first_name": "Ada",
    "last_name": "Lovelace",
    "custom_fields": {
      "company": "Analytical Engines"
    },
    "unsubscribed": false,
    "updated_at": "2026-09-30T16:48:55.120000+00:00",
    "created_at": "2026-09-20T14:22:09.418000+00:00",
    "audiences": [
      {
        "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
        "subscriber": {
          "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
          "subscribed": true,
          "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
          "unsubscribed_at": null
        }
      }
    ]
  },
  "data": {
    "object": {
      "id": "con_2xLf5Jk1Xs7Nc2Ur8Zo3Ld6Pt0a",
      "object": "contact",
      "email": "ada@example.com",
      "first_name": "Ada",
      "last_name": "Lovelace",
      "custom_fields": {
        "company": "Analytical Engines"
      },
      "unsubscribed": false,
      "updated_at": "2026-09-30T16:48:55.120000+00:00",
      "created_at": "2026-09-20T14:22:09.418000+00:00",
      "audiences": [
        {
          "id": "aud_2xLi5Ez0Ut7Aq2Wf4Bp9Mg6Nv1i",
          "subscriber": {
            "id": "sub_2xLj6Fa1Vu8Br3Xg5Cq0Nh7Ow2j",
            "subscribed": true,
            "subscribed_at": "2026-09-20T14:22:09.418302+00:00",
            "unsubscribed_at": null
          }
        }
      ]
    }
  }
}

Questa pagina ti è stata utile?

Grazie del feedback.

Grazie, leggiamo ogni messaggio.