Webhooks Changelog

In this guide, you'll find the notable changes to the webhook events that Medusa delivers, with the newest change listed first. Each entry is grouped by the date the change went live.

Refer to the Webhook Reference for the current payload of every event.

October 23, 2026#

Delivery#

Cloud now blocks webhook delivery to endpoints that resolve to private or internal network addresses. Attempts to deliver to such URLs will fail immediately with a network error rather than timing out or returning an HTTP error. This affects any customer whose webhook endpoint URL resolves to a loopback, link-local, or other non-public IP address; those deliveries will be recorded as failed and will be retried according to the normal retry schedule.

August 10, 2026#

Medusa released webhooks for Cloud organizations with the following events:

build.canceled#

  • Added the build.canceled event. Cloud delivers this event when a build is canceled.

build.created#

  • Added the build.created event. Cloud delivers this event when a build is created for an environment.

build.failed#

  • Added the build.failed event. Cloud delivers this event when a build fails.

build.succeeded#

  • Added the build.succeeded event. Cloud delivers this event when a build completes successfully.

deployment.canceled#

  • Added the deployment.canceled event. Cloud delivers this event when a deployment is canceled.

deployment.created#

  • Added the deployment.created event. Cloud delivers this event when a deployment is created for an environment.

deployment.failed#

  • Added the deployment.failed event. Cloud delivers this event when a deployment fails.

deployment.succeeded#

  • Added the deployment.succeeded event. Cloud delivers this event when a deployment completes successfully.
Was this guide helpful?
Ask Bloom
For assistance in your development, use Claude Code Plugins or Docs MCP server in Cursor, VSCode, etc...FAQ
What is Medusa?
How can I create a module?
How can I create a data model?
How do I create a workflow?
How can I extend a data model in the Product Module?
Recipes
How do I build a marketplace with Medusa?
How do I build digital products with Medusa?
How do I build subscription-based purchases with Medusa?
What other recipes are available in the Medusa documentation?
Chat is cleared on refresh
Line break
⇧↵