What are webhooks?
Webhooks are automatic HTTP calls that send data from your Shoporama online store to a URL of your choice. When a certain event occurs - for example, a new order or a change in stock status - Shoporama instantly sends a message to your server with all relevant data.
Instead of constantly asking the API "has something new happened?", webhooks proactively tell you when there is something to react to. This results in lower latency, less load and a more elegant integration.
Supported events
Shoporama supports webhooks for a wide range of events, grouped into four categories:
Orders
- Order created - When a new order comes in
- New status - When the status of an order changes (e.g. from "New" to "Shipped")
- Paid - When the payment for an order is registered
Products
- Product changed - When a product is created or updated
- Inventory changed - When inventory is changed
- Category changed - When categories are created, changed or deleted
Checkout flow
- Added to cart - When a customer adds a product to the cart
- Cart updated - When the cart is changed
- Checkout steps - Visiting cart page, address page, shipping page, approval page and thank you page
- Order approved - When the order is finally approved
Customers and other
- Customer created - When a new customer is registered
- Newsletter signup - When a visitor signs up for the newsletter
- New return - When a customer creates a return request
Security and reliability
Each webhook is signed with a unique secret, which is automatically generated at creation. This allows your server to verify that the call really comes from Shoporama and is not a fake.
Shoporama delivers webhooks asynchronously via an internal queue, so events are not lost even if your server is temporarily down. You can view the log of delivered webhooks at any time, including status, response time, and any errors.
Log and debugging
All webhook deliveries are logged with details such as:
- Time of delivery
- Type of event
- HTTP status code from your server
- Response time
- Option to resend individual webhooks
You can filter the log by event type, status and date - and you can send test webhooks to verify that your integration is working properly before going live.
Statistics
For each webhook, you can view statistics over the past 30 days with number of deliveries, success rate and error distribution. This gives you a quick overview of whether your integrations are running smoothly.
Create via the API
In addition to the admin panel, webhooks can also be created and managed programmatically via the REST API. This allows apps and integrations to set up their own webhooks automatically.
Typical usage scenarios
- ERP integration: Send new orders directly to your ERP system the moment they are created
- Stock alerts: Get notified when a product is running low in stock
- Marketing automation: Trigger email flows based on customer behavior at checkout
- Slack notifications: Send a message to your Slack channel with every new order
- Custom dashboards: Build your own real-time dashboard with live order data