# Magento new customer notifications on your phone

> Get a low-priority push notification when someone creates a customer account in your Magento shop, or one is added in the admin or through the API.

- Company: Magento (https://www.justpush.io/recipes/magento)
- Event: `customer.registered` (Customer registered)
- Tags: E-commerce, Sign-ups & users
- Install: https://studio.justpush.io/recipes/magento/customer-registered
- Web page: https://www.justpush.io/recipes/magento/customer-registered

## Setup

1. Click Install in Studio and sign in. The recipe is added to your account and you get a personal webhook URL.
2. Install the JustPush module in your shop: composer require justpush/magento-module-notify, then bin/magento setup:upgrade.
3. In the Magento admin, open Stores > Configuration > Services > JustPush and set Enabled to Yes.
4. Paste your webhook URL (shown in Studio after install) into the Customer registered field, click Save Config, then click Send test.
5. Magento has no outgoing webhooks, so this recipe needs the free **JustPush module** in your shop ([source](https://github.com/JustPush-io/justpush-magento)). Install it once; it serves every Magento recipe:
6. ```bash
7. composer require justpush/magento-module-notify
8. bin/magento setup:upgrade
9. bin/magento cache:flush
10. ```
11. Then open **Stores → Configuration → Services → JustPush** in the Magento admin, set **Enabled** to **Yes**, paste the URL above into the **Customer registered** field and click **Save Config**. Click **Send test**: this recipe answers with a quiet "🔔 Magento connected".
12. Guest checkouts don't create a customer account, so they don't trigger this recipe.
13. The module sends from Magento's message queue, so Magento cron has to run (it usually does). Without cron, set **Send immediately (no cron)** to **Yes**.
14. The **Open customer** button opens the Magento admin. With Magento's default **Add Secret Key to URLs** setting, it lands on the dashboard rather than the page itself.
15. Requests aren't signed, so keep the URL private.

## Code

Studio calls `handleRequest(request)` with the incoming webhook (`{ method, headers, body, query, raw }`) and sends the message object it returns. Returning `null` sends nothing.

```js
// Magento → customer registered
// Fires when the JustPush module (justpush/magento-module-notify) reports a "customer.registered"
// event: a new customer account from the storefront, the admin or the API.
// Docs: https://github.com/JustPush-io/justpush-magento

// The module sends plain strings; treat blanks and nulls as missing.
function text(value) {
    return typeof value === "string" && value.trim() ? value.trim() : null
}

// Only link to real http(s) URLs.
function link(url, cta) {
    return typeof url === "string" && /^https?:\/\//.test(url) ? [{ cta, url }] : []
}

// Which shop sent it, so owners of several websites can tell them apart.
function shop(store) {
    if (!store || typeof store !== "object") return null
    const url = text(store.url)
    const host = url && /^https?:\/\//.test(url) ? url.replace(/^https?:\/\//, "").replace(/\/.*$/, "") : null
    return text(store.website) ?? text(store.store_view) ?? host
}

// The module's "Send test" button; every Magento recipe answers it.
function testPing(body) {
    const from = shop(body.store)
    return {
        title: "🔔 Magento connected",
        message: from ? `${from} is sending to this recipe` : "Your shop is sending to this recipe",
        topic: "Magento",
        priority: -1, // Low — you just clicked the button
    }
}

function pick(table, key, fallback) {
    return typeof key === "string" && Object.prototype.hasOwnProperty.call(table, key) ? table[key] : fallback
}

function handleRequest(request) {
    const body = request.body && typeof request.body === "object" ? request.body : {}

    if (body.event === "test.ping") return testPing(body)

    // Guard: only handle this recipe's event, so other Magento events on this integration stay quiet.
    const customer = body.customer
    if (body.event !== "customer.registered" || !customer || typeof customer !== "object") {
        console.log(`Ignoring Magento event "${body.event ?? "unknown"}"`)
        return null
    }

    const name = text(customer.name)
    const email = text(customer.email)
    const who = name && email ? `${name} (${email})` : name ?? email ?? "Someone"
    const group = text(customer.group)

    return {
        title: "👤 New customer",
        message: [
            `${who} created an account`,
            pick({ admin: "added in the admin", api: "via the API" }, customer.source, null),
            group && group !== "General" ? `group: ${group}` : null,
            shop(body.store),
        ]
            .filter(Boolean)
            .join(" · "),
        topic: "Magento",
        priority: -1, // Low — nice to know, nothing to do
        buttons: link(customer.admin_url, "Open customer"),
    }
}
```

## Magento customer.registered webhook payload (sample)

```json
{
  "event": "customer.registered",
  "store": {
    "url": "https://shop.example.com/",
    "website": "Main Website",
    "store_view": "Default Store View"
  },
  "sent_at": "2026-09-30T14:29:28Z",
  "version": 1,
  "customer": {
    "name": "Jane Doe",
    "email": "jane.doe@example.com",
    "group": "General",
    "source": "frontend",
    "admin_url": "https://shop.example.com/admin/customer/index/edit/id/5/"
  }
}
```

## FAQ

### 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 Magento 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.