API 参考Webhooks
Register a new webhook endpoint
Registers an HTTPS endpoint to receive event notifications.
The response includes a secret field — shown only once.
Use it to verify HMAC-SHA256 signatures on deliveries.
Requires webhooks:manage scope. Requires Idempotency-Key header.
Delivery: POST to URL with JSON body, HMAC signature in X-Webhook-Signature header. Retries: 3 attempts (10s, 60s, 300s backoff). After 3 failures, webhook is deactivated.
Authorization
apiKey AuthorizationBearer <token>
API key: Authorization: Bearer mpk_live_<key>
In: header
Header Parameters
Idempotency-Key*string
UUID v4. Required on all write operations. Prevents duplicate execution on retry.
Format
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
curl -X POST "https://motivation-money.vercel.app/api/v1/webhooks" \ -H "Idempotency-Key: 7f3c4d2a-8b1e-4f6a-9c2d-1a5b8e3f7d4c" \ -H "Content-Type: application/json" \ -d '{ "url": "https://agent.acme.com/webhooks/payroll", "events": [ "payroll.run.created" ] }'Empty