Skip to main content

🔗 Webhook Integration – Send real-time return data to your own system

Jeppe Oestergaard Hansen avatar
Written by Jeppe Oestergaard Hansen
Updated over 2 months ago

The Returnflows webhook integration lets you send real-time return and shipment events to your own system – like ERP, data warehouse, or notification tools.

🧰 What is a webhook?

A webhook is a live data trigger that sends structured JSON payloads to a URL you define.
Whenever a selected event happens, we’ll notify your system instantly.

Perfect for syncing return data with ERP, updating order status, or triggering internal flows.

✅ How to activate the integration

  1. Go to Settings → Integrations

  2. Find Webhook and click Install
    ​

🛠 Webhook Setup

You’ll now be asked to fill in:

Webhook URL

The endpoint URL to receive the data
→ Example: https://erp.example.com/return-notify

Secret Key

A string used to sign all payloads
→ Use HMAC to validate webhook origin

🔔 Events you can subscribe to

When using the webhook integration in Returnflows, you can subscribe to the following events:

Event

Description

return.created

A return was created by the customer

return.completed

The return was created and is ready for processing

return.processed

The return has been internally processed

return.canceled

The return was canceled

return.paused

The return or order was paused

return.resumed

The return was resumed (unpaused)

return.closed

The return was completed and closed

return.instant_exchange

Exchange was released due to Instant Exchange

return.reset

The return was reset

return.label_generated

A return label was generated

return.auto_close_initiated

Auto-close countdown started

return.auto_close_cancelled

Auto-close was canceled (e.g., due to missing tracking)

return.auto_close_completed

Return was successfully auto-closed

return.auto_close_failed

Auto-close failed (e.g., due to refund error)

shipment.event.in_transit

Shipment is in transit

shipment.event.delivered

Shipment has been delivered

🧪 Payload format & signing

  • Payload is sent as JSON

  • Headers include an HMAC signature

  • Sign using your Secret Key to validate the source

🔄 Retry logic

If your endpoint doesn’t respond with 200 OK, Returnflows retries automatically (with backoff).

💡 Use cases

  • Push return data to ERP/CRM

  • Sync order status with internal tools

  • Log return metrics in your BI stack

  • Send internal alerts via Slack, Teams etc.

🙋 Need help?

Need help building your webhook endpoint or testing payloads?

💬 Chat with us – we’re happy to assist with your setup.

Did this answer your question?