{"uid":"cap_C2bok0PwQaHfIsr9YK2Ji","slug":"zensched-webhook-register-9c347de8","name":"ZenSched Webhook Register","description":"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","url":"https://mcp.zensched.com/x402/tools/webhook_register?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yiwabuYZEfYC7AOILD-YT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Register an HTTPS webhook to receive real-time ZenSched event notifications for worker, shift, form, timesheet, and billing events","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Real-time shift check-in alerting","prompt":"Set up a ZenSched webhook at https://ops.mycompany.com/hooks/shifts to listen for shift.checkin and shift.checkout events so our ops dashboard updates in real time — let ZenSched generate the signing secret."},{"title":"Low balance billing notification","prompt":"Register a webhook on ZenSched pointing to https://alerts.mycompany.com/billing for billing.low_balance events so we get notified before our prepaid balance runs out."},{"title":"Worker onboarding pipeline trigger","prompt":"Hook up https://hr.mycompany.com/zensched-events on ZenSched to fire on worker.invited and worker.activated events so we can automatically trigger our onboarding workflow whenever a new field worker joins."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T18:33:29.309Z","isFirstParty":false,"canonicalSlug":"zensched-webhook-register-9c347de8"}