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

EventDescription
Order CreatedTriggered when a new order is placed.
Order CanceledTriggered when an order is canceled.
Order ReturnedTriggered when a return is initiated for an order.
Order Ship To Address UpdatedTriggered when a retailer updates the shipping address for an order.

Connections

EventDescription
Connection CreatedTriggered when a supplier-retailer connection is created.
Connection EstablishedTriggered when a connection becomes active and ready for order flow.

Proposals

EventDescription
Proposal ApprovedTriggered when a product proposal is approved by a merchant.
Proposal CompletedTriggered when a proposal is marked as complete.
Proposal DeclinedTriggered when a proposal is declined by a merchant.
Proposal RevisedTriggered when a proposal is updated by the supplier.
Proposal Collaborator AddedTriggered when a collaborator is added to a proposal.
Proposal Owner ReassignedTriggered when ownership of a proposal is reassigned.
Proposal Pricing ApprovedTriggered when proposed pricing is approved.
Proposal Product ApprovedTriggered when a product within a proposal is approved.
Proposal Product RejectedTriggered when a product within a proposal is rejected.
Proposal Variant ApprovedTriggered when a product variant is approved.
Proposal Variant RejectedTriggered when a product variant is rejected.
Proposal Variant RemovedTriggered when a product variant is removed from a proposal.

Returns (RMAs)

EventDescription
RMA ApprovedTriggered when a return merchandise authorization (RMA) is approved.
RMA RejectedTriggered when an RMA request is rejected.
RMA CompletedTriggered when an RMA is marked as completed.
RMA Return ApprovedTriggered when the return items within an RMA are approved.
RMA Return ReceivedTriggered when returned items are physically received.
RMA Return RejectedTriggered when returned items are rejected during processing.

Adding a webhook

  1. 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.
  2. Click Webhooks (Advanced). The Webhooks page is displayed.
  3. On the Webhooks page, click Add Webhook. The Add Webhook window is displayed.
  4. In the Topic field, select the event you want to subscribe to.
  5. 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.
  6. In the URL field, enter the publicly accessible endpoint where you want to receive the webhook.
  7. In the Status field, select whether the webhook should be Enabled or Disabled.
  8. 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.