AckdbEntityEvent

Immutable company or human activity. Sole-person events have null entityId/contactId and a non-null personId, even when the human has employers.

Properties

idstringrequired

ULID identifier for the event.

entityIdstring | nullrequired

sourcestringrequired

Source system that produced this event.

eventTypestringrequired

Type of event (e.g. message, payment, subscription_change).

summarystringrequired

Human-readable summary of the event.

metadataobjectrequired

Source-specific event metadata.

timestampstring <date-time>required

When this event occurred in the source system.

createdAtstring <date-time>required

When this event record was created in ackDB.

contactIdstring | nullrequired

personIdstring | nullrequired

Example

AckdbEntityEvent example

{
  "id": "01HXYZ123456789ABCDEFGH",
  "entityId": null,
  "source": "slack",
  "eventType": "message",
  "summary": "Customer asked about pricing in #acme-corp",
  "metadata": {},
  "timestamp": "1970-01-01T00:00:00.000Z",
  "createdAt": "1970-01-01T00:00:00.000Z",
  "contactId": null,
  "personId": null
}