Build webhook

Configure a URL and Orbiter fires a POST to it automatically when an entry is published — or manually from the dashboard.

Setup

Go to Settings → Build and paste your webhook URL.

When it fires

• Automatically — when an entry transitions from draft to published (via the status toggle in the entry list, or clicking Publish in the editor)
• Manually — via the Trigger build button on the dashboard

The webhook fires asynchronously — a failed request does not block the publish action. build.last_triggered is updated on each fire.

Netlify

Site configuration → Build & deploy → Build hooks → Add build hook

Copy the hook URL and paste it into Orbiter's Settings → Build.

Vercel

Project settings → Git → Deploy Hooks → Create hook

GitHub Actions

GitHub requires an Authorization header for workflow_dispatch. Use a small proxy or a webhook relay service that adds the header:

# Using a Cloudflare Worker or similar proxy:
POST https://your-worker.workers.dev/gh-dispatch
# Worker adds: Authorization: Bearer YOUR_GITHUB_TOKEN
# and forwards to GitHub's API

Alternatively, use a service like smee.io or Zapier as a relay.

Custom server

Any URL that accepts a POST request works. Orbiter sends no body and no special headers — just the POST.

// Example: Express endpoint that triggers a shell command
app.post('/build', (req, res) => {
  res.sendStatus(200);
  exec('npm run build && npm run deploy');
});