langfuse-webhooks-events

name	langfuse-webhooks-events
description	Configure Langfuse webhooks for prompt change notifications and event-driven workflows. Use when setting up prompt change notifications, triggering CI/CD on prompt updates, or integrating Langfuse events with Slack and external systems. Trigger with phrases like "langfuse webhooks", "langfuse events", "langfuse notifications", "langfuse prompt webhook", "langfuse alerts".
allowed-tools	Read, Write, Edit
version	1.12.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","langfuse","webhooks"]
compatibility	Designed for Claude Code, also compatible with Codex and OpenClaw

Langfuse Webhooks & Events

Overview

Configure Langfuse webhooks to receive notifications on prompt version changes. Langfuse supports webhook events for prompt lifecycle: Created, Updated (labels/tags changed), and Deleted. Use webhooks to trigger CI/CD pipelines, sync prompts to external systems, or notify teams via Slack.

Prerequisites

• Langfuse Cloud or self-hosted instance
• HTTPS endpoint to receive webhook POST requests
• Webhook secret for HMAC signature verification

Instructions

Step 1: Create Webhook Endpoint

// app/api/webhooks/langfuse/route.ts (Next.js App Router)
import { NextRequest, NextResponse } from "next/server";
import crypto from "crypto";

const WEBHOOK_SECRET = process.env.LANGFUSE_WEBHOOK_SECRET!;

interface LangfuseWebhookEvent {
  event: "prompt.created" | "prompt.updated" | "prompt.deleted";
  timestamp: string;
  data: {
    promptName: string;
    promptVersion: number;
    labels?: string[];
    projectId: string;
    [key: string]: any;
  };
}

// Verify HMAC SHA-256 signature
function verifySignature(payload: , : ):  {
   expected = crypto
    .(, )
    .(payload)
    .();

   crypto.(
    .(signature),
    .(expected)
  );
}

   () {
   payload =  request.();
   signature = request..();

  
   (!signature || !(payload, signature)) {
     .({ :  }, { :  });
  }

   :  = .(payload);
  .();

   (event.) {
     :
       (event.);
      ;
     :
       (event.);
      ;
     :
       (event.);
      ;
  }

   .({ :  });
}

  () {
  
   (data.?.()) {
     (data., data.);
  }

   ({
    : ,
    : data.,
  });
}

  () {
  
   (data.?.()) {
     ({
      : ,
    });
  }
}

  () {
   ({
    : ,
    : ,
  });
}