# Eventi dei contatti

> Contatti creati, aggiornati o eliminati.



## contact.created

> Inviato quando viene creato un contatto tramite l’API o il pannello. Include le liste a cui è stato aggiunto.

# contact.created

Inviato quando viene creato un contatto con [Crea un contatto](/it/docs/api-reference/contacts/create/). Se passi `audiences`, Emailit invia anche [`subscriber.created`](/it/docs/webhooks/events/subscriber/created/) per ogni lista.

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": "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
          }
        }
      ]
    }
  }
}
```

## 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 `contact.created`.

- `object` (object): Il contatto 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 contatto

- `id` (string): ID del contatto (`con_…`).

- `object` (string): Sempre `contact`.

- `email` (string): Indirizzo del contatto, in minuscolo.

- `first_name` (string | null): Nome.

- `last_name` (string | null): Cognome.

- `custom_fields` (object): Valori dei campi personalizzati, indicizzati per campo. Vedi [Campi personalizzati](/it/docs/contacts/custom-fields/).

- `unsubscribed` (boolean): Indica se il contatto è disiscritto da tutte le campagne.

- `created_at` (string): Quando è stato creato il contatto, in formato ISO 8601 con offset UTC.

- `audiences` (object[]): 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`.

---
Fonte: https://emailit.com/it/docs/webhooks/events/contact/contact-created/

## contact.updated

> Inviato quando un contatto cambia. Include i valori precedenti dei campi modificati, come l’indirizzo email o il nome.

# contact.updated

Inviato quando un contatto cambia, con [Aggiorna un contatto](/it/docs/api-reference/contacts/update/) o con le azioni `unsubscribe` e `resubscribe` delle [azioni di massa sui contatti](/it/docs/api-reference/contacts/bulk/). Le modifiche alle liste generano anche gli [eventi degli iscritti](/it/docs/webhooks/events/subscriber/).

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": "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"
      }
    }
  }
}
```

## 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 `contact.updated`.

- `object` (object): Il contatto 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 contatto

- `id` (string): ID del contatto (`con_…`).

- `object` (string): Sempre `contact`.

- `email` (string): Indirizzo del contatto, in minuscolo.

- `first_name` (string | null): Nome.

- `last_name` (string | null): Cognome.

- `custom_fields` (object): Valori dei campi personalizzati, indicizzati per campo. Vedi [Campi personalizzati](/it/docs/contacts/custom-fields/).

- `unsubscribed` (boolean): Indica se il contatto è disiscritto da tutte le campagne.

- `updated_at` (string): Quando è stato aggiornato l’ultima volta il contatto, in formato ISO 8601 con offset UTC.

- `created_at` (string): Quando è stato creato il contatto.

- `audiences` (object[]): 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`.

- `previous` (object): Valori precedenti dei campi modificati tra `email`, `first_name`, `last_name`, `unsubscribed` e `custom_fields`. Omesso se nessuno di questi campi è cambiato.

---
Fonte: https://emailit.com/it/docs/webhooks/events/contact/contact-updated/

## contact.deleted

> Inviato quando viene eliminato un contatto. Il payload è il contatto, con le sue liste, com’era prima dell’eliminazione.

# contact.deleted

Inviato quando viene eliminato un contatto con [Elimina un contatto](/it/docs/api-reference/contacts/delete/) o con l’azione di massa `delete`. Prima Emailit invia [`subscriber.deleted`](/it/docs/webhooks/events/subscriber/deleted/) per ogni lista a cui apparteneva il contatto.

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": "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
          }
        }
      ]
    }
  }
}
```

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

- `object` (object): Il contatto 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 contatto

- `id` (string): ID del contatto (`con_…`).

- `object` (string): Sempre `contact`.

- `email` (string): Indirizzo del contatto, in minuscolo.

- `first_name` (string | null): Nome.

- `last_name` (string | null): Cognome.

- `custom_fields` (object): Valori dei campi personalizzati, indicizzati per campo. Vedi [Campi personalizzati](/it/docs/contacts/custom-fields/).

- `unsubscribed` (boolean): Indica se il contatto è disiscritto da tutte le campagne.

- `updated_at` (string): Quando è stato aggiornato l’ultima volta il contatto, in formato ISO 8601 con offset UTC.

- `created_at` (string): Quando è stato creato il contatto.

- `audiences` (object[]): 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`.

---
Fonte: https://emailit.com/it/docs/webhooks/events/contact/contact-deleted/
