Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.buttons.sh/llms.txt

Use this file to discover all available pages before exploring further.

​
buttons webhook

Expose a local URL via Cloudflare to receive webhook callbacks

​
Synopsis

Drawer steps occasionally need to register a public URL with a third- party service (Apify, GitHub, Stripe) and wait for it to post back. The webhook subsystem manages a Cloudflare tunnel to your local machine so that URL works without hosting anything yourself. Two modes: quick zero setup. Each webhook step spawns a fresh Quick Tunnel (ephemeral *.trycloudflare.com URL). Good when the service accepts a per-run webhook URL. named stable hostname on your own Cloudflare account. Set up once via ‘buttons webhook setup’. Required when a service wants a fixed URL registered up front (e.g. GitHub webhooks). Prereq: ‘cloudflared’ binary on PATH. Install via ‘brew install cloudflared’. Verbs: buttons webhook setup — one-time: Cloudflare login + pick a hostname buttons webhook status — show current mode + hostname buttons webhook test — end-to-end round-trip verify buttons webhook listen — run the dispatcher that presses triggered drawers buttons webhook logout — forget the named-tunnel config (quick mode again) 
buttons webhook [flags]

​
Options

  -h, --help   help for webhook

​
Options inherited from parent commands

      --json       output in JSON format
      --no-input   disable all interactive prompts
      --summary    show a read-only plan/snapshot instead of mutating

​
SEE ALSO