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, updated, or deleted.

​
Supported Events

EventTrigger
post.createdA new post is created
post.updatedA post is updated
post.publishedA post status changes to Published
post.deletedA post is deleted
category.createdA new category is created
category.updatedA category is updated
category.deletedA category is deleted
tag.createdA new tag is created
tag.updatedA tag is updated
media.uploadedNew media is added to the library

​
Setup

Configure webhooks through the Publive Dashboard:
  1. Go to Settings > Webhooks
  2. Click Add Webhook
  3. Enter your endpoint URL
  4. Select the events you want to subscribe to
  5. Save

​
Payload Format

{
  "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: 
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