Paddle new subscription notifications on your phone.
Get a push notification when a customer starts a Paddle subscription, with the product, price and any trial.
Tuesday 29 September
9:41
JustPushnow
New subscription
Get a push notification when a customer starts a Paddle subscription, with the product, price and any trial.
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 Paddle
Add it as a webhook for subscription.created.
STEP 03
Get a push on your phone
With the text, sound and buttons from the recipe.
How to set up the Paddle subscription.created webhook
- Click Install in Studio and sign in. The recipe is added to your account and you get a personal webhook URL.
- In Paddle, go to Developer tools > Notifications and click New destination.
- Choose Webhook as the type and paste your webhook URL as the URL.https://••••••••/•••••••• your personal URL, shown after install
- Select the subscription.created event and save the destination.
- The **View subscription** button opens the live Paddle dashboard. Paddle doesn't say in the event whether it came from sandbox or live, so if you're testing in sandbox, change `DASHBOARD` at the top of the code to `https://sandbox-vendors.paddle.com`.
- Paddle signs each webhook with a `Paddle-Signature` header, but JustPush doesn't verify it yet. Keep your endpoint URL private.
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// Paddle → subscription created
2// Fires when a customer starts a new subscription.
3// Docs: https://developer.paddle.com/webhooks/overview
4//
5// Paste this into a JustPush Studio integration and add a Paddle notification destination
6// for the "subscription.created" event pointing at the integration's endpoint URL.
7
8// Paddle amounts are strings in the currency's smallest unit ("4900" = €49.00),
9// except for zero-decimal currencies such as JPY, where "500" means ¥500.
10const ZERO_DECIMAL = new Set(["jpy", "krw"])
11
12function money(amount, currency) {
13 const units = Number(amount)
14
15 // Don't invent a figure when the event doesn't carry one.
16 if (amount == null || amount === "" || !Number.isFinite(units) || !currency) return null
17
18 const code = String(currency).toLowerCase()
19 const value = ZERO_DECIMAL.has(code) ? units : units / 100
20
21 try {
22 return new Intl.NumberFormat("en-GB", { style: "currency", currency: code }).format(value)
23 } catch {
24 return `${value} ${code.toUpperCase()}`
25 }
26}
27
28// Paddle events don't say whether they came from sandbox or live, so set this yourself.
29// Sandbox: "https://sandbox-vendors.paddle.com"
30const DASHBOARD = "https://vendors.paddle.com"
31
32// Paddle timestamps are ISO 8601 strings.
33function day(iso) {
34 return new Date(iso).toLocaleDateString("en-GB", {
35 day: "numeric",
36 month: "short",
37 timeZone: "UTC",
38 })
39}
40
41// Describe the first subscription item, e.g. "AeroEdit Pro — €30.00/month".
42function plan(subscription) {
43 const items = subscription.items ?? []
44 const item = items[0]
45 const price = item?.price
46
47 if (!price) return null
48
49 const name = item.product?.name ?? price.name
50 const cycle = price.billing_cycle ?? subscription.billing_cycle
51 const every = !cycle
52 ? ""
53 : cycle.frequency > 1
54 ? ` every ${cycle.frequency} ${cycle.interval}s`
55 : `/${cycle.interval}`
56 const each = money(Number(price.unit_price?.amount) * (item.quantity ?? 1), price.unit_price?.currency_code)
57 const cost = each ? each + every : null
58 const more = items.length > 1 ? ` + ${items.length - 1} more` : ""
59
60 return [name, cost].filter(Boolean).join(" — ") + more || null
61}
62
63function handleRequest(request) {
64 const event = request.body
65
66 // Guard: only handle this event type, so other Paddle events on this integration stay quiet.
67 if (!event?.data || event.event_type !== "subscription.created") {
68 console.log(`Ignoring Paddle event "${event?.event_type ?? "unknown"}"`)
69 return null
70 }
71
72 const subscription = event.data
73 const summary = plan(subscription) ?? "A new subscription"
74 const trialEnds = subscription.items?.[0]?.trial_dates?.ends_at
75 const trial = subscription.status === "trialing" && trialEnds ? ` (trial until ${day(trialEnds)})` : ""
76
77 return {
78 title: "🎉 New subscription",
79 message: summary + trial,
80 topic: "Paddle",
81 priority: 0, // Normal — recurring revenue, worth a smile
82 sound: "cashregister",
83 buttons: [{ cta: "View subscription", url: `${DASHBOARD}/subscriptions-v2/${subscription.id}` }],
84 }
85}
The Paddle subscription.created webhook
This is what Paddle sends to your URL for subscription.created. It is a sample, trimmed to the fields recipes use.
subscription.created · sample.json
1{
2 "data": {
3 "id": "sub_01jpro",
4 "items": [
5 {
6 "price": {
7 "id": "pri_01jmonthly",
8 "name": "Monthly",
9 "product_id": "pro_01jaeroedit",
10 "unit_price": {
11 "amount": "3000",
12 "currency_code": "EUR"
13 },
14 "description": "Monthly",
15 "billing_cycle": {
16 "interval": "month",
17 "frequency": 1
18 }
19 },
20 "status": "trialing",
21 "product": {
22 "id": "pro_01jaeroedit",
23 "name": "AeroEdit Pro",
24 "status": "active"
25 },
26 "quantity": 1,
27 "recurring": true,
28 "trial_dates": {
29 "ends_at": "2026-10-12T09:30:00.000000Z",
30 "starts_at": "2026-09-28T09:30:00.000000Z"
31 }
32 }
33 ],
34 "status": "trialing",
35 "customer_id": "ctm_01jjane",
36 "billing_cycle": {
37 "interval": "month",
38 "frequency": 1
39 },
40 "currency_code": "EUR",
41 "next_billed_at": "2026-10-12T09:30:00.000000Z"
42 },
43 "event_id": "evt_01jsubscriptioncreated",
44 "event_type": "subscription.created",
45 "occurred_at": "2026-09-28T09:30:00.000000Z",
46 "notification_id": "ntf_01jsubscriptioncreated"
47}
Paddle new subscription 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 Paddle 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.
Ready when you are
Paddle on your phone in two minutes.
Install the recipe, paste one URL, done. Free for 30 days, no credit card required.