# Contact events

> Contacts created, updated or deleted.



## contact.created

> Sent when a contact is created through the API or the dashboard. Includes the audiences it was added to.

# contact.created

Sent when a contact is created with [Create a contact](/docs/api-reference/contacts/create/). If you pass `audiences`, Emailit also sends [`subscriber.created`](/docs/webhooks/events/subscriber/created/) for each audience.

Webhook requests carry a JSON array of events like this one; see [Webhook requests](/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
          }
        }
      ]
    }
  }
}
```

## Fields

- `event_id` (string): Event ID (`evt_…`). A retried request carries the same ID, so use it to skip events you already handled. You can also look the event up with [Retrieve an event](/docs/api-reference/events/get/).

- `type` (string): Always `contact.created`.

- `object` (object): The contact the event describes. Its fields are listed below.

- `data.object` (object): The same object again, in the shape that the [Events API](/docs/api-reference/events/get/) returns in `data`.

### Contact object

- `id` (string): Contact ID (`con_…`).

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

- `email` (string): Contact address, in lowercase.

- `first_name` (string | null): First name.

- `last_name` (string | null): Last name.

- `custom_fields` (object): Custom field values keyed by field. See [Custom fields](/docs/contacts/custom-fields/).

- `unsubscribed` (boolean): Whether the contact is unsubscribed from all campaigns.

- `created_at` (string): When the contact was created, in ISO 8601 with a UTC offset.

- `audiences` (object[]): Audiences the contact belongs to. Each item has the audience `id` and a `subscriber` object with `id`, `subscribed`, `subscribed_at` and `unsubscribed_at`.

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

## contact.updated

> Sent when a contact changes. Includes the previous values of the fields that changed, such as the email address or name.

# contact.updated

Sent when a contact changes, with [Update a contact](/docs/api-reference/contacts/update/) or the `unsubscribe` and `resubscribe` actions of [bulk contact actions](/docs/api-reference/contacts/bulk/). Audience changes also send [subscriber events](/docs/webhooks/events/subscriber/).

Webhook requests carry a JSON array of events like this one; see [Webhook requests](/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"
      }
    }
  }
}
```

## Fields

- `event_id` (string): Event ID (`evt_…`). A retried request carries the same ID, so use it to skip events you already handled. You can also look the event up with [Retrieve an event](/docs/api-reference/events/get/).

- `type` (string): Always `contact.updated`.

- `object` (object): The contact the event describes. Its fields are listed below.

- `data.object` (object): The same object again, in the shape that the [Events API](/docs/api-reference/events/get/) returns in `data`.

### Contact object

- `id` (string): Contact ID (`con_…`).

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

- `email` (string): Contact address, in lowercase.

- `first_name` (string | null): First name.

- `last_name` (string | null): Last name.

- `custom_fields` (object): Custom field values keyed by field. See [Custom fields](/docs/contacts/custom-fields/).

- `unsubscribed` (boolean): Whether the contact is unsubscribed from all campaigns.

- `updated_at` (string): When the contact was last updated, in ISO 8601 with a UTC offset.

- `created_at` (string): When the contact was created.

- `audiences` (object[]): Audiences the contact belongs to. Each item has the audience `id` and a `subscriber` object with `id`, `subscribed`, `subscribed_at` and `unsubscribed_at`.

- `previous` (object): Old values of the fields that changed among `email`, `first_name`, `last_name`, `unsubscribed` and `custom_fields`. Omitted when none of them changed.

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

## contact.deleted

> Sent when a contact is deleted. The payload is the contact, with its audiences, as it was before deletion.

# contact.deleted

Sent when a contact is deleted with [Delete a contact](/docs/api-reference/contacts/delete/) or the bulk `delete` action. Emailit first sends [`subscriber.deleted`](/docs/webhooks/events/subscriber/deleted/) for each audience the contact belonged to.

Webhook requests carry a JSON array of events like this one; see [Webhook requests](/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
          }
        }
      ]
    }
  }
}
```

## Fields

- `event_id` (string): Event ID (`evt_…`). A retried request carries the same ID, so use it to skip events you already handled. You can also look the event up with [Retrieve an event](/docs/api-reference/events/get/).

- `type` (string): Always `contact.deleted`.

- `object` (object): The contact the event describes. Its fields are listed below.

- `data.object` (object): The same object again, in the shape that the [Events API](/docs/api-reference/events/get/) returns in `data`.

### Contact object

- `id` (string): Contact ID (`con_…`).

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

- `email` (string): Contact address, in lowercase.

- `first_name` (string | null): First name.

- `last_name` (string | null): Last name.

- `custom_fields` (object): Custom field values keyed by field. See [Custom fields](/docs/contacts/custom-fields/).

- `unsubscribed` (boolean): Whether the contact is unsubscribed from all campaigns.

- `updated_at` (string): When the contact was last updated, in ISO 8601 with a UTC offset.

- `created_at` (string): When the contact was created.

- `audiences` (object[]): Audiences the contact belongs to. Each item has the audience `id` and a `subscriber` object with `id`, `subscribed`, `subscribed_at` and `unsubscribed_at`.

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