Workers - Deploy Hooks are now available for Workers Builds
Key Points
- Trigger builds via simple POST
- Automatic deduplication of redundant builds
- Rate limits: 10/min per Worker, 100/min per account
Summary
Workers Builds now supports Deploy Hooks — unique POSTable URLs tied to a specific branch that trigger a build and deploy when called. Create hooks in the dashboard (Workers & Pages > your Worker > Settings > Builds > Deploy Hooks) and invoke them from any system that can send an HTTP POST (CMS webhooks, Cron Triggers, Slack commands, other Workers).
Key Points
- Trigger builds with a simple POST to the hook URL, e.g.
curl -X POST "https://api.cloudflare.com/client/v4/workers/builds/deploy_hooks/<DEPLOY_HOOK_ID>" - Each Deploy Hook is bound to a branch and visible in build history (shows which hook started each build) and dashboard (shows last triggered time).
- You can call hooks from other Workers (example: a Worker with a Cron Trigger calling
fetch(env.DEPLOY_HOOK_URL, { method: "POST" })). - Useful for CMS publish events, scheduled rebuilds, Slack slash commands, or any system that can POST a URL.
- Built-in optimizations: automatic deduplication skips redundant builds if multiple triggers occur before the first build starts.
- Rate limits: 10 builds per minute per Worker, 100 builds per minute per account; refer to Limits & pricing for full details.
Getting started
- Open Workers & Pages > your Worker > Settings > Builds > Deploy Hooks.
- Create a Deploy Hook for the target branch.
- Send a POST to the returned URL from your CMS, CI, Cron Worker, or any HTTP-capable system.
Read the Deploy Hooks documentation for implementation details and edge cases.