Everything you need to integrate and build.

Canonical Liulum Event Envelope

All webhook events, probes, and automation callbacks are ingested and recorded in this canonical typed envelope.

type LiulumEvent<T> = {
  eventId: string;           // UUID v4
  eventType: string;         // e.g. "signal.received" | "webhook.delivered" | "outcome.observed"
  eventVersion: number;      // e.g. 1
  tenantId: string;          // Customer workspace ID
  projectId?: string;        // Target project ID
  revenuePathId?: string;    // Monitored Revenue Path ID
  incidentId?: string;       // Linked incident ID
  correlationId: string;     // Cross-service correlation ID
  causationId?: string;      // Triggering event ID
  idempotencyKey: string;    // Unique deduplication key
  source: {
    type: "probe" | "journey" | "webhook" | "provider" | "agent" | "user" | "system";
    id: string;
  };
  observedAt: string;        // ISO 8601 timestamp
  receivedAt: string;        // Ingest timestamp
  dataClassification: "public" | "internal" | "confidential" | "restricted";
  evidenceRefs: string[];    // Array of evidence ledger keys
  payload: T;
};