{
  "slug": "stripe-listen-unifies-event-selection-and-forwarding-flags-61a03959219d",
  "title": "stripe listen unifies event selection and forwarding flags",
  "tools": [
    "stripe-cli"
  ],
  "tags": [
    "agent"
  ],
  "introduced_at": "2026-09-17T22:37:49.000Z",
  "announced_at": "2026-09-17T22:37:49.000Z",
  "effective_at": null,
  "date_basis": "source-publication",
  "status": "unknown",
  "how": {
    "incantation": "When forwarding Stripe webhook events locally, select event types with `--events` or all snapshot/thin events with `--all-snapshot` or `--all-thin`, then set a destination with `--forward-to` or `--forward-connect-to`. Use `--events-from` to choose account sources; a single endpoint cannot receive both snapshot and thin payload styles.",
    "examples": [
      "stripe listen --events <snapshot-event>,<thin-event> --forward-to localhost:3000/events",
      "stripe listen --all-snapshot --forward-to localhost:3000/events",
      "stripe listen --all-thin --events-from @accounts --forward-to localhost:3000/events"
    ],
    "gotchas": [
      "Version: v1.51.0",
      "--events <event>[,<event>...]: Comma-separated snapshot event names and/or thin event names (thin names such as `v1.billing.meter.no_meter_found`). Select this or an all-events flag when forwarding.",
      "--all-snapshot: Subscribe to all snapshot events. Mutually exclusive with `--all-thin` and with selected events of the other payload style; one endpoint cannot receive both styles.",
      "--all-thin: Subscribe to all thin events. Mutually exclusive with `--all-snapshot` and with selected events of the other payload style; one endpoint cannot receive both styles.",
      "--forward-to <url>: URL to forward events to; required in practice to forward to a local endpoint.",
      "--forward-connect-to <url>: URL for Connect events; defaults to `--forward-to`. Cannot be used with `--events-from @self`.",
      "--events-from <value>: Account source: `@self` (your account only), `@accounts` (connected accounts only), or `all` (default). With `@accounts`, different values for `--forward-to` and `--forward-connect-to` are ambiguous.",
      "--events '*': Unsupported because the wildcard is ambiguous with thin events. Use `--all-snapshot` or `--all-thin`.",
      "--thin-events: Deprecated; use `--events` for selected snapshot/thin types or `--all-thin` for all thin events. Hidden from help.",
      "--forward-thin-to: Deprecated; use `--forward-to` with selected thin events or `--all-thin`. Snapshot and thin events cannot share one destination. Hidden from help.",
      "--forward-thin-connect-to: Deprecated; use `--events-from @accounts` with thin event selection and `--forward-to <url>`. Hidden from help.",
      "Prerequisite: Forwarding requires an explicit event subscription: use `--events`, `--all-snapshot`, or `--all-thin`.",
      "Deprecated thin-specific flags continue working with warnings and replacement guidance; they stay out of `--help`.",
      "The former thin-specific flags are planned to be rejected in a later release after documentation is updated.",
      "`--events '*'` became ambiguous once thin events existed."
    ]
  },
  "why_it_matters": "Forward snapshot and thin events to a local endpoint with `stripe listen`.",
  "before": "Previously, thin event selection and forwarding used the parallel flags `--thin-events`, `--forward-thin-to`, and `--forward-thin-connect-to`.",
  "sources": [
    "https://github.com/stripe/stripe-cli/releases/tag/v1.51.0",
    "https://github.com/stripe/stripe-cli/pull/2006",
    "https://github.com/stripe/stripe-cli/blob/v1.51.0/pkg/cmd/listen.go"
  ],
  "rank": 0.97061,
  "judge": {
    "publish": true,
    "judge_model": "codex-cli/gpt-6-luna+typesafe/jev-1.13.0",
    "prompt_version": "extract-v7+enrich-v2+judge-v2x3+jev-publish-v1"
  },
  "review_state": "approved",
  "provenance": {
    "run_id": "wave1-20261014",
    "verdict_id": "wave1-20261014:wave1-20261014-23bb25a283b1e0ad-1:gate",
    "evidence_hash": "910829fe5ceb0028528946cbbe5f8647c3141d4be442c4477da5f109ec606513"
  },
  "review": {
    "draft_hash": "291ba1ce15bb27832d79840160f1735fa59a6fee2324044472e2514ef8bb507b",
    "reviewer": "publication-gate",
    "reviewed_at": "2026-10-07T00:00:00.000Z",
    "decision": "wave1-20261014:gate",
    "reason": "3 of 3 judge runs approved with p_yes >= 0.9 (mean 0.97 >= 0.9; 2 needed) and Jev gave 0.78 (>= 0.6 needed)."
  }
}