Features: Webhooks in Marble

Webhooks make it easy to keep your site fresh and automate workflows. Whenever something happens in your Marble workspace—like publishing a post—we can send an HTTP POST payload to a URL you configure.

They’re powered by Upstash QStash, so events are delivered reliably.

Use Cases

• Content Revalidation → Trigger rebuilds for SSG frameworks (Next.js, Astro, Nuxt) so updates go live instantly.

• Automations → Send newsletters, share posts on social, or sync content when a post.published event fires.

Setting Up

1. Go to Webhooks in the Marble dashboard.

2. Click Create Webhook → add name, URL, events.

3. Copy the secret to verify requests.

Verifying Requests

Marble sends a x-marble-signature header. You can use your secret to confirm authenticity.

Example Payload (tag.deleted)

{
  "event": "tag.deleted",
  "data": {
    "id": "cmf3d1gsv11469tlkp53bcutv",
    "slug": "news-and-updates",
    "userId": "cms96emp70001l60415sft0i5"
  }
}

Supported Events

• post.published

• post.updated

• post.deleted

• tag.*

• category.*

• media.deleted Readmore here: https://docs.marblecms.com/content/guides/webhooks