Skip to content
Docs

vercel deploy-hooks

The vercel deploy-hooks command manages Deploy Hooks. A deploy hook is a URL that, when called with an HTTP POST, triggers a new deployment of a specific Git branch. They are useful for triggering redeploys from external systems like content management systems and cron schedulers.

terminal
vercel deploy-hooks [subcommand]

Using the vercel deploy-hooks command to manage deploy hook URLs for the current project.

Lists deploy hooks for the current (or specified) project.

terminal
vercel deploy-hooks list
vercel deploy-hooks list --json
vercel deploy-hooks list --project my-app
List deploy hooks. Use --json for machine-readable output.
OptionTypeDescription
--jsonBooleanOutput as JSON
-p, --project <NAME_OR_ID>StringProject to list deploy hooks for (defaults to the linked project)

Creates a new deploy hook for a Git branch. The CLI returns the hook URL.

terminal
vercel deploy-hooks create cms-rebuild --git-branch main

Create a deploy hook named cms-rebuild that deploys the main branch when the URL is called.

ArgumentRequiredDescription
nameNoDisplay name for the deploy hook
OptionTypeDescription
--git-branch <BRANCH>StringGit branch to deploy when the hook URL is triggered
-p, --project <NAME_OR_ID>StringProject to create the deploy hook in (defaults to the linked project)

Deletes a deploy hook by ID. Use vercel deploy-hooks list first to find the hook ID.

terminal
vercel deploy-hooks delete hook_abc123
Delete a deploy hook by ID.
ArgumentRequiredDescription
idYesID of the deploy hook to delete
OptionTypeDescription
-p, --project <NAME_OR_ID>StringProject containing the deploy hook (defaults to the linked project)
-y, --yesBooleanSkip the confirmation prompt. Takes effect with --non-interactive
terminal
vercel deploy-hooks create cms-rebuild --git-branch main

Wire the returned URL into your CMS's publish webhook to trigger a production redeploy whenever content changes.

terminal
vercel deploy-hooks list --json
Useful for syncing hook URLs with external systems.
terminal
vercel deploy-hooks delete hook_abc123 --yes --non-interactive
Skip the confirmation prompt; appropriate for CI scripts.

The following global options can be passed when using the vercel deploy-hooks command:

For more information on global options and their usage, refer to the options section.

Last updated June 9, 2026

Was this helpful?

supported.