CLI · tofu hooks

Create and manage webhook URLs with tofu hooks

A hook is a stable provider URL that survives restarts, branches, and machine swaps. Create one per provider, then point that provider at the URL Tofu prints.

CLI

$ tofu hooks create stripe --name "Stripe"

Create a hook with the slug stripe and a human-readable display name. The slug is what you reference from every other command.

CLI

$ tofu hooks list

List every hook in the active workspace, with slug, name, and provider URL.

CLI

$ tofu hooks url stripe

Print the provider URL for a hook. Paste it into the provider's webhook settings.

CLI

$ tofu hooks status stripe

Show the hook's current status, recent event volume, and whether any targets are disabled.

Typical setup

Create a hook, copy its URL, paste it into the provider. The URL never changes again, so you do not need to revisit the provider dashboard when your local environment moves.

Terminal

$ tofu hooks create stripe --name "Stripe"$ tofu hooks url stripe$ # paste the URL into Stripe's webhook endpoint settings