Use the Webhooks page to subscribe to real-time events from fabric Dropship. Webhooks allow your external systems to receive automatic updates when key actions occur, such as inventory changes, order events, or shipment updates.
Once configured, fabric sends an HTTP request to your specified URL whenever a subscribed event occurs. You can view and manage all configured webhooks, including their delivery status, from this page.
Supported Webhook Events
You can subscribe to the following event types. When an event occurs, fabric sends a real-time HTTP request to your configured webhook endpoint.
Orders
| Event | Description |
|---|
| Order Created | Triggered when a new order is placed. |
| Order Canceled | Triggered when an order is canceled. |
| Order Returned | Triggered when a return is initiated for an order. |
| Order Ship To Address Updated | Triggered when a retailer updates the shipping address for an order. |
Connections
| Event | Description |
|---|
| Connection Created | Triggered when a supplier-retailer connection is created. |
| Connection Established | Triggered when a connection becomes active and ready for order flow. |
Proposals
| Event | Description |
|---|
| Proposal Approved | Triggered when a product proposal is approved by a merchant. |
| Proposal Completed | Triggered when a proposal is marked as complete. |
| Proposal Declined | Triggered when a proposal is declined by a merchant. |
| Proposal Revised | Triggered when a proposal is updated by the supplier. |
| Proposal Collaborator Added | Triggered when a collaborator is added to a proposal. |
| Proposal Owner Reassigned | Triggered when ownership of a proposal is reassigned. |
| Proposal Pricing Approved | Triggered when proposed pricing is approved. |
| Proposal Product Approved | Triggered when a product within a proposal is approved. |
| Proposal Product Rejected | Triggered when a product within a proposal is rejected. |
| Proposal Variant Approved | Triggered when a product variant is approved. |
| Proposal Variant Rejected | Triggered when a product variant is rejected. |
| Proposal Variant Removed | Triggered when a product variant is removed from a proposal. |
Returns (RMAs)
| Event | Description |
|---|
| RMA Approved | Triggered when a return merchandise authorization (RMA) is approved. |
| RMA Rejected | Triggered when an RMA request is rejected. |
| RMA Completed | Triggered when an RMA is marked as completed. |
| RMA Return Approved | Triggered when the return items within an RMA are approved. |
| RMA Return Received | Triggered when returned items are physically received. |
| RMA Return Rejected | Triggered when returned items are rejected during processing. |
Adding a webhook
-
Click your business name in the menu at the top of the page in Dropship and click Supplier Settings.
The Supplier Settings page is displayed.
-
Click Webhooks (Advanced).
The Webhooks page is displayed.
-
On the Webhooks page, click Add Webhook.
The Add Webhook window is displayed.
-
In the Topic field, select the event you want to subscribe to.
-
In the Method field, select the HTTP method to use, whether POST, PUT, or PATCH.
This determines how the event payload is sent to your server.
-
In the URL field, enter the publicly accessible endpoint where you want to receive the webhook.
-
In the Status field, select whether the webhook should be Enabled or Disabled.
-
Click Add Webhook to save the configuration.
The webhook is created.
Your endpoint must respond with a 2xx HTTP status code to confirm successful delivery. If a webhook fails, fabric may attempt retries based on a backoff strategy.
Viewing webhook history
After configuration, you can monitor recent deliveries and failures on the Webhooks page in the Webhook History section. This helps confirm that events are triggering correctly and that your system is responding as expected. 