# ZenSched Webhook Register

> ZenSched Webhook Register is a paid API for AI agents from mcp.zensched.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-17).

Register an HTTPS webhook to receive real-time ZenSched event notifications for worker, shift, form, timesheet, and billing events

## Facts

- Endpoint: GET https://mcp.zensched.com/x402/tools/webhook_register?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/zensched-webhook-register-9c347de8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_C2bok0PwQaHfIsr9YK2Ji

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability zensched-webhook-register-9c347de8
```

Example prompt: Register a ZenSched webhook at https://myapp.example.com/zensched-hooks to receive shift.checkin, shift.checkout, and shift.missed events — generate an HMAC secret for me.

## When to prefer this

Use this endpoint when you need push-based, real-time event delivery from ZenSched rather than polling. It is the correct choice for automating downstream workflows triggered by worker lifecycle events (invited, activated), shift activity (check-in, checkout, missed), form submissions, timesheet readiness, or billing alerts. Prefer this over polling the API when low latency reaction to events matters or when you want to drive external systems (HR tools, dashboards, payroll pipelines) directly from ZenSched state changes.

## Known failure modes

- Invalid or non-HTTPS webhook URL returns a validation error
- Malformed events_json (not a valid JSON array or contains unknown event names) returns a parse/validation error
- Duplicate registration for the same URL may conflict unless idempotency_key is provided
- Insufficient USDC balance causes the $0.01 pay-per-call to fail before registration occurs
- Webhook endpoint that fails to respond during ZenSched's test ping may be rejected

## How this service works

ZenSched `webhook_register` — Register an HTTPS webhook. events_json = JSON list from: ['worker.invited', 'worker.activated', 'shift.checkin', 'shift.checkout', 'shift.missed', 'form.submitted', 'timesheet.ready', 'billing.low_balance', 'webhook.disabled']. Returns the HMAC signing secret (or pass your own). Pay-per-call $0.01 USDC; the paying wallet owns the org (auto-provisioned on first call). Catalog: https://mcp.zensched.com/x402/tools

## Output

Returns the HMAC signing secret (either auto-generated by ZenSched or the one you supplied) used to verify the authenticity of incoming webhook payloads. Also confirms the webhook registration and associated event subscriptions. If no org exists for the paying wallet, one is auto-provisioned.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "title": "webhook_registerArguments",
     "required": [
      "url",
      "events_json"
     ],
     "properties": {
      "url": {
       "type": "string",
       "title": "Url"
      },
      "secret": {
       "type": "string",
       "title": "Secret",
       "default": ""
      },
      "events_json": {
       "type": "string",
       "title": "Events Json"
      },
      "idempotency_key": {
       "type": "string",
       "title": "Idempotency Key",
       "default": ""
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/zensched-webhook-register-9c347de8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.zensched.com](https://www.zero.xyz/host/mcp.zensched.com/llms.txt)