contact.updated

type: contact.updated

Fired when any consumer-visible field on a contact changes.

When it fires

Profile fields (name, phone, email) are edited.
Tags are added or removed.
System or custom fields change.
Any write through People API, flow cards, or admin UI.

`data` shape

type Data = {
  contact: ContactPayload;
  previous?: Partial<ContactPayload>;
};

contact — the post-update state. See ContactPayload.
previous — optional, only the fields that changed (pre-update values).

Example envelope

{
  "id": "evt_22334455-6677-8899-aabb-ccddeeff0011",
  "type": "contact.updated",
  "timestamp": "2026-04-24T10:30:00.000Z",
  "data": {
    "contact": {
      "peopleId": "6804f4d5a6f9f35f6e66f1a2",
      "phoneNumber": "+46700000000",
      "firstName": "Alex",
      "lastName": "Stone",
      "tags": ["lead", "newsletter"],
      "updatedAt": "2026-04-24T10:30:00.000Z"
    },
    "previous": {
      "lastName": "",
      "tags": ["lead"]
    }
  },
  "meta": {
    "eventId": "evt_22334455-6677-8899-aabb-ccddeeff0011",
    "event": "contact.updated",
    "occurredAt": "2026-04-24T10:30:00.000Z",
    "organisationId": "6640f3d5c8a0d7e8b7f20222",
    "connectionId": "6640f45ac8a0d7e8b7f2014a",
    "apiVersion": "2026-04-01",
    "attempt": 1
  }
}

contact.updated

When it fires

data shape

Example envelope

Related

On this page

`data` shape