Skip to main content

🔗 Integration with PeakWMS – Manage returns directly from your warehouse

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

By integrating Returnflows with PeakWMS, you create a seamless link between your webshop and warehouse system.

When a return is created in Returnflows, it is automatically sent to PeakWMS. Once it is processed and closed in Peak, the return is also closed in Returnflows.


🎥 Video guide


🛠 How to set up the integration

✅ Step 1 – Create an API key in PeakWMS

  1. Go to the gear icon → Settings → Integrations → Webshop Integration

  2. Click “Add new integration”

  3. Choose PeakWMS API

  4. Name the integration, e.g., Returnflows

  5. Enable “Allow access to data from other integrations”

  6. Enter a random Bearer token (you can generate one on random.org)

  7. Click Save

  8. Copy the API key displayed after saving


✅ Step 2 – Set up integration in Returnflows

  1. Go to Settings → Integrations → PeakWMS

  2. Click “Install”

  3. Enter:

    • The API Key from Step 1, point 8

    • The Webhook Secret from Step 1, point 6

  4. Click “Install”

The technical connection is now active.


✅ Step 3 – Contact PeakWMS support

For the integration to work fully, PeakWMS must activate webhook listening so Returnflows can receive updates.

🟡 Returnflows typically handles this step for you – but you can also send the email yourself.

📩 Email to: [email protected]

Subject: [Your Company Name] x Returnflows

Email template:


Hi Peak,
As part of setting up our Returnflows integration to our PeakWMS system, we would like our webhook to listen to events from the Shopify integration in Peak – such as when a return is closed.

Flemming previously mentioned this needs to be manually enabled.

Integration name: Returnflows
PeakWMS account: [Your account name]
CVR (Company Reg.): [Your CVR number]



🔄 How the integration works

  • A customer starts a return in Returnflows

  • The return is automatically created in PeakWMS

  • When the return is closed in Peak (via scanner or dashboard), it is also closed in Returnflows

This works for all return types – refunds, gift cards, and exchanges.


❓ FAQ

Do I need to send the email to Peak myself?
No – Returnflows can send it on your behalf. Just contact support.

Can I use the integration without webhook access?
No – webhook listening must be enabled by PeakWMS support.

What if I have multiple integrations in Peak?
Just make sure “Allow access to data from other integrations” is enabled.


🙋 Need help?

Need assistance or want us to set it up for you?
💬 Chat with us – we’ll help make sure everything works.

Did this answer your question?