hf webhooks manages Hub webhooks
Introduced 2026-03-06 · score 0.91
HOW TO USE IT
When managing Hugging Face Hub webhooks from the terminal, use `hf webhooks` to list or inspect them, create or update them, enable or disable them, and delete them.
hf webhooks ls
hf webhooks info <webhook_id>hf webhooks create --url <https://example.com/hook> --watch <type:name>
hf webhooks update <webhook_id> --url <https://new-url.com/hook>hf webhooks enable <webhook_id>
hf webhooks disable <webhook_id>
hf webhooks delete <webhook_id>WHY THIS HELPS
Manage Hub webhooks from the terminal while working with a repository's Hub integration.
REQUIREMENTS AND LIMITATIONS
- Version: v1.6.0
- <webhook_id> (required): Webhook ID for info, update, enable, disable, or delete.
- --watch <type:name> (required): Item to watch; repeatable. The value uses `type:name` format.
- --url <url>: URL to send webhook payloads to; for creation, mutually exclusive with `--job-id`, and one of the two must be provided.
- --job-id <id>: Job ID to trigger instead of pinging a URL; for creation, mutually exclusive with `--url`, and one of the two must be provided.
- --domain <repo|discussions>: Domain to watch; repeatable and defaults to all domains.
- --secret <secret>: Optional secret used to sign webhook payloads.
- --token <token>: Token option accepted by the webhook commands to override authentication.
- Prerequisite: Install the `huggingface_hub` package to use the `hf` CLI; the CLI guide also documents standalone and `uvx` installation options.
FIRST-PARTY EVIDENCE
- https://github.com/huggingface/huggingface_hub/releases/tag/v1.6.0
- https://github.com/huggingface/huggingface_hub/blob/v1.6.0/src/huggingface_hub/cli/webhooks.py
- https://github.com/huggingface/huggingface_hub/blob/v1.6.0/docs/source/en/guides/cli.md
Check the installed version and the source before using it. Entry JSON