Subscribe your backend to Sippet events

type SippetWebhookEnvironment = "live" | "sandbox";
type SippetWebhookPayloadVersion = "2026-05-25";

type EmailClassificationWebhookEventType =
  | "email.classification.created"
  | "email.classification.updated"
  | "email.classification.classified";

type EmailClassificationStatus = "pending" | "classified" | "failed";
type EmailClassificationEffectiveSource = "model" | "manual";

export type EmailClassificationWebhookEvent = {
  id: string;
  type: EmailClassificationWebhookEventType;
  version: SippetWebhookPayloadVersion;
  occurred_at: string;
  organisation_id: string;
  environment: SippetWebhookEnvironment;
  data: {
    id: string;
    message_id: string | null;
    status: EmailClassificationStatus;
    predicted_label: string | null;
    predicted_confidence: number | null;
    confidence_threshold: number | null;
    effective_label: string | null;
    effective_source: EmailClassificationEffectiveSource | null;
    before_label: string | null;
    after_label: string | null;
    provider: string;
    model: string;
    taxonomy_version: string;
    prompt_version: string;
    token_usage: Record<string, unknown> | null;
    estimated_cost: string | null;
    provider_response_id: string | null;
    last_error: string | null;
    classified_at: string | null;
    overridden_at: string | null;
    overridden_by_user_id: string | null;
    inserted_at: string;
    updated_at: string;
  };
};