Skip to content
Docs

Contacts created, updated or deleted.

contact.created

Sent when a contact is created with Create a contact. If you pass audiences, Emailit also sends subscriber.created for each audience.

Webhook requests carry a JSON array of events like this one; see Webhook requests.

Fields

event_idstring

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.

typestring

Always contact.created.

objectobject

The contact the event describes. Its fields are listed below.

data.objectobject

The same object again, in the shape that the Events API returns in data.

Contact object

idstring

Contact ID (con_…).

objectstring

Always contact.

emailstring

Contact address, in lowercase.

first_namestring | null

First name.

last_namestring | null

Last name.

custom_fieldsobject

Custom field values keyed by field. See Custom fields.

unsubscribedboolean

Whether the contact is unsubscribed from all campaigns.

created_atstring

When the contact was created, in ISO 8601 with a UTC offset.

audiencesobject[]

Audiences the contact belongs to. Each item has the audience id and a subscriber object with id, subscribed, subscribed_at and 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

Sent when a contact changes, with Update a contact or the unsubscribe and resubscribe actions of bulk contact actions. Audience changes also send subscriber events.

Webhook requests carry a JSON array of events like this one; see Webhook requests.

Fields

event_idstring

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.

typestring

Always contact.updated.

objectobject

The contact the event describes. Its fields are listed below.

data.objectobject

The same object again, in the shape that the Events API returns in data.

Contact object

idstring

Contact ID (con_…).

objectstring

Always contact.

emailstring

Contact address, in lowercase.

first_namestring | null

First name.

last_namestring | null

Last name.

custom_fieldsobject

Custom field values keyed by field. See Custom fields.

unsubscribedboolean

Whether the contact is unsubscribed from all campaigns.

updated_atstring

When the contact was last updated, in ISO 8601 with a UTC offset.

created_atstring

When the contact was created.

audiencesobject[]

Audiences the contact belongs to. Each item has the audience id and a subscriber object with id, subscribed, subscribed_at and unsubscribed_at.

previousobject

Old values of the fields that changed among email, first_name, last_name, unsubscribed and custom_fields. Omitted when none of them changed.

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

Sent when a contact is deleted with Delete a contact or the bulk delete action. Emailit first sends subscriber.deleted for each audience the contact belonged to.

Webhook requests carry a JSON array of events like this one; see Webhook requests.

Fields

event_idstring

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.

typestring

Always contact.deleted.

objectobject

The contact the event describes. Its fields are listed below.

data.objectobject

The same object again, in the shape that the Events API returns in data.

Contact object

idstring

Contact ID (con_…).

objectstring

Always contact.

emailstring

Contact address, in lowercase.

first_namestring | null

First name.

last_namestring | null

Last name.

custom_fieldsobject

Custom field values keyed by field. See Custom fields.

unsubscribedboolean

Whether the contact is unsubscribed from all campaigns.

updated_atstring

When the contact was last updated, in ISO 8601 with a UTC offset.

created_atstring

When the contact was created.

audiencesobject[]

Audiences the contact belongs to. Each item has the audience id and a subscriber object with id, subscribed, subscribed_at and 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
          }
        }
      ]
    }
  }
}

Was this page helpful?

Thanks for the feedback.

Thanks, we read every message.