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
Event Trigger 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:
Go to Configuration > Webhooks
Click Create New Webhook
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.
Click Create New Webhook
Show Full payload example
{
"event" : "post.published" ,
"timestamp" : "2026-02-12T10:00:00Z" ,
"data" : {
"id" : 50123 ,
"title" : "My Published Article" ,
"slug" : "my-published-article" ,
"type" : "Article" ,
"status" : "Published" ,
"primary_category" : {
"id" : 100 ,
"name" : "News"
}
}
}
Verification
Webhook requests include a signature header for verification:
Show Signature verification details
X-Publive-Signature: sha256=...
Verify the signature by computing HMAC-SHA256 of the request body using your webhook secret.
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