Get started

Sendcloud return created notifications on your phone.

Get a push notification when a customer creates a return through the Sendcloud Return Portal.

Install in Studio See the setup
return_createdE-commerceOrders
How it works

Three steps to your first push

STEP 01

Install the recipe

One click in Studio gives you a personal webhook URL.

STEP 02

Paste your URL into Sendcloud

Add it as a webhook for Return created.

STEP 03

Get a push on your phone

With the text, sound and buttons from the recipe.

Setup

How to set up the Sendcloud return created webhook

  1. Click Install in Studio and sign in. The recipe is added to your account and you get a personal webhook URL.
  2. In Sendcloud, go to Settings > Integrations and click Configure on your API integration.
  3. Tick Webhook feedback enabled and paste your webhook URL as the Webhook URL.https://••••••••/•••••••• your personal URL, shown after install
  4. Save, then press Test API webhook.
  5. Use the same API integration webhook as for parcel statuses (**Settings → Integrations → Configure → Webhook feedback enabled**). Returns made through the Return Portal or the API trigger it; the manual return form doesn't.
  6. Sendcloud signs deliveries with `Sendcloud-Signature` (HMAC-SHA256), but JustPush doesn't check it yet, so keep your endpoint URL private.
The code

What runs when the webhook arrives

Studio calls handleRequest(request) with the incoming webhook and sends the message it returns. It's yours after install; change anything.

transform.js
1// Sendcloud → return created
2// Fires when a customer creates a return through the Sendcloud Return Portal or the API.
3// Docs: https://sendcloud.dev/api/v3/webhooks
4
5function handleRequest(request) {
6 const body = request.body || {}
7 const data = body.data
8
9 // Guard: only return_created webhooks.
10 if (body.action !== "return_created" || !data) {
11 console.log(`Ignoring Sendcloud "${body.action ?? "unknown"}" webhook`)
12 return null
13 }
14
15 const items = Array.isArray(data.items) ? data.items : []
16 const count = items.reduce((sum, item) => sum + (Number(item?.quantity) || 1), 0)
17 const first = items[0]?.description
18
19 return {
20 title: `↩️ Return created${data.order_number ? ` for order ${data.order_number}` : ""}`,
21 message:
22 (count ? `${count} item${count === 1 ? "" : "s"}` : "A return") +
23 (first ? ` — ${first}${items.length > 1 ? ` + ${items.length - 1} more` : ""}` : ""),
24 topic: "Sendcloud",
25 priority: 0, // Normal — a parcel is coming back
26 }
27}
Payload

The Sendcloud return_created webhook

This is what Sendcloud sends to your URL for return created. It is a sample, trimmed to the fields recipes use.

return_created · sample.json
1{
2 "data": {
3 "id": 55123,
4 "items": [
5 {
6 "sku": "PIN-01",
7 "item_id": "a1",
8 "quantity": 2,
9 "description": "Enamel Pin"
10 },
11 {
12 "sku": "STK-01",
13 "item_id": "a2",
14 "quantity": 1,
15 "description": "Sticker Pack"
16 }
17 ],
18 "brand_id": 12,
19 "refund_type": "money",
20 "order_number": "1234",
21 "return_reason_id": 3
22 },
23 "action": "return_created",
24 "timestamp": 1790672400000
25}
FAQ

Sendcloud return created notifications: questions

Does this work on iPhone and Android?

Yes. Install the JustPush app from the App Store or Google Play and sign in. Every phone signed in to your account gets the notification.

Do I need to write code?

No. Install the recipe in Studio, paste your webhook URL into Sendcloud and you are done. The code is there if you want to change the text, the sound or the buttons.

Can I change what the notification says?

Yes. After install the recipe's code is yours. Edit it in Studio and test it against the sample payload before you save.

What does it cost?

JustPush is free for 30 days. After that it's $19.99 a year, or $39.99 once. There is no extra charge for recipes.

More recipes

More from Sendcloud

Sendcloud

Parcel status

Get a push notification when a Sendcloud parcel is delivered, waiting for pickup, delayed, or runs into a problem.

parcel_status_changedButtons

All 2 Sendcloud recipes

Orders

More orders recipes

Shopify

New order

Get a push notification with the customer, total and item count every time a new order is placed in your store, with a button to open the order.

orders/createSoundButtonsSigned
WooCommerce

Low or out of stock

Get a push notification when a WooCommerce product runs low or sells out, with how many are left.

product.updatedButtons
WooCommerce

New customer

Get a low-priority push notification when someone creates a customer account in your WooCommerce store.

customer.createdButtons

All orders recipes

Ready when you are

Sendcloud on your phone in two minutes.

Install the recipe, paste one URL, done. Free for 30 days, no credit card required.

Install in Studio Download for iOS Download for Android