{"version":"2.0","protocol":"Webhook Discovery Protocol","generated_at":"2026-05-09T16:27:27.922704Z","webhookCapabilities":{"supportedEvents":[{"event":"pr.published","description":"Fired when a press release is published"},{"event":"pr.updated","description":"Fired when a published press release is updated"},{"event":"pr.deleted","description":"Fired when a press release is deleted"},{"event":"pr.view","description":"Fired when a press release is viewed"},{"event":"pr.click","description":"Fired when a link in a press release is clicked"},{"event":"journalist.outreach_sent","description":"Fired when outreach email is sent to a journalist"},{"event":"investor.outreach_sent","description":"Fired when outreach email is sent to an investor"}],"eventCount":7,"maxSubscriptionsPerUser":10,"deliveryModel":"fire-and-forget"},"security":{"signatureAlgorithm":"HMAC-SHA256","signatureHeader":"X-Webhook-Signature","eventHeader":"X-Webhook-Event","timestampHeader":"X-Webhook-Timestamp","contentType":"application/json","requireHttpsInProduction":true},"retryPolicy":{"maxAttempts":3,"backoffDelays":[5,15,60],"backoffType":"exponential","autoDisableThreshold":10,"timeoutSeconds":10},"endpoints":{"subscribe":{"method":"POST","path":"/api/v1/webhooks/subscribe","description":"Create a new webhook subscription","authentication":"required"},"list":{"method":"GET","path":"/api/v1/webhooks","description":"List your webhook subscriptions","authentication":"required"},"test":{"method":"POST","path":"/api/v1/webhooks/{webhook_id}/test","description":"Send a test event to your webhook","authentication":"required"},"delete":{"method":"DELETE","path":"/api/v1/webhooks/{webhook_id}","description":"Delete a webhook subscription","authentication":"required"},"events":{"method":"GET","path":"/api/v1/webhooks/events","description":"List supported events","authentication":"none"},"discovery":{"method":"GET","path":"/api/v1/webhooks/discovery","description":"This endpoint (webhook capability discovery)","authentication":"none"}},"rateLimits":{"subscribe":"10 requests per hour","list":"60 requests per minute","test":"20 requests per hour","delete":"20 requests per hour"},"examplePayload":{"event":"pr.published","timestamp":"2026-01-06T12:00:00Z","data":{"id":"uuid-here","headline":"Company Announces New Product","slug":"company-announces-new-product","url":"https://pressonify.ai/news/company-announces-new-product","published_at":"2026-01-06T12:00:00Z"}},"documentation":{"apiDocs":"https://pressonify.ai/docs/webhooks","exampleCode":"https://pressonify.ai/examples/webhook_integration_example.py","supportEmail":"support@pressonify.ai"},"features":["event-filtering","custom-filters","retry-with-backoff","auto-disable-on-failure","failure-tracking","hmac-signing","fire-and-forget-delivery"]}