Skip to main content
Webhooks allow you to receive real-time HTTP callbacks when events occur in your Publive CMS, such as content being published or a reader joining your newsletter.

Supported events

EventTrigger
post.publishedA post status changes to Published
reader.addedA new reader is added to your workspace
reader.removedA reader is removed from your workspace
newsletter.subscribeA member subscribes to your newsletter
form.submittedA form is submitted

Setup

Configure webhooks through the Publive Dashboard:
  1. Go to Configuration > Webhooks
  2. Click Create New Webhook
  3. Configure the following fields:
    • Target URL (Required): The endpoint URL where webhook payloads will be sent.
    • Api Secret: A secret key used to verify the webhook payload signature.
    • Alert Email: An email address to receive notifications if the webhook fails.
    • Select Events(Required): Choose the specific events you want to subscribe to.
  4. Click Create New Webhook

Payload format

Verification

Webhook requests include a signature header for verification:

Best practices

  • Respond with 200 quickly, process the payload asynchronously
  • Implement idempotency as webhooks may be delivered more than once
  • Use HTTPS endpoints for security
  • Validate signatures to ensure requests are from Publive
Last modified on April 17, 2026