How to use Storyblok webhooks

If you you want to trigger an action like cache clearing, or you want to start a build process when new content gets published, you’ll need a webhook.

We have a webhook which you can configure in the space settings under “Published Story Webhook”. Whenever new content gets published, Storyblok will send a POST request with story_id as a JSON payload. It expects to receive a 2xx status and Content-Type: application/json as response.

Example

Available webhooks

Published & unpublished story

Example Payload:

{
  "action": "published",
  "text": "The user test@domain.com published the Story XYZ (xyz)",
  "story_id": 123,
  "space_id": 123
}

Completed branch deployment

requires the app “Branches and Releases”

Example Payload:

{
  "action": "branch_deployed",
  "text": "The branch Live has been deployed.",
  "branch_id": 123,
  "space_id": 123
}

If you need to listen to other events check out the events documentation of the Storyblok Bridge.