Webhooks

Live stream of webhook events for the calling org (SSE)

Opens a Server-Sent Events stream that emits every webhook event the org generates while the connection is open. Best-effort and single-instance — receivers that need at-least-once delivery should register a real webhook endpoint (POST /v1/webhooks) instead; this stream is for development, debugging, and live-watch CLIs. Each event arrives as an SSE frame with event: <type> and a JSON data: body matching the WebhookEnvelope shape. Optional ?events=signup.created,signup.updated filters to specific types; unknown values are dropped silently. The server emits SSE comments as a heartbeat every 15s. Vercel's serverless ceiling caps the stream at ~5 minutes; clients should reconnect.

get/webhooks/events

Request

  • Base URL: https://thesignup.app/api/v1
  • URL: https://thesignup.app/api/v1/webhooks/events
  • Auth: HTTP bearer

Query parameters

eventsstring

Comma-separated list of WebhookEventType values to filter on. Omit to receive every event type.

Example:signup.created,participant.registered

Response

Streaming response (text/event-stream). The connection stays open until the client disconnects or the serverless function reaches its time limit.

Changes

No recorded changes to this operation across all 1 revision of this API.