# Expo store submission notifications on your phone

> Get a push notification when EAS Submit uploads your app to App Store Connect or Google Play, and a High-priority one when the submission fails.

- Company: Expo (https://www.justpush.io/recipes/expo)
- Event: `SUBMIT` (SUBMIT)
- Tags: Mobile apps, Releases & app review
- Install: https://studio.justpush.io/recipes/expo/submission
- Web page: https://www.justpush.io/recipes/expo/submission

## Setup

1. Click Install in Studio and sign in. The recipe is added to your account and you get a personal webhook URL.
2. In your project's directory, run eas webhook:create and choose the SUBMIT event.
3. Paste your webhook URL (shown in Studio after install) as the webhook URL.
4. Enter any signing secret of at least 16 characters. EAS requires one, but JustPush doesn't check it yet.
5. Webhooks are per project: repeat this in every project you want to hear about.
6. Run this in your project's directory (it needs EAS CLI and a logged-in account):
7. ```
8. eas webhook:create --event SUBMIT --url "your webhook URL (shown in Studio after install)"
9. ```
10. EAS asks for a signing secret of at least 16 characters; any random value works. Webhooks are set per project, so repeat this in each project.
11. A finished submission means EAS uploaded the build: on iOS Apple still has to process it before it appears in TestFlight (the App Store Connect **Build processing** recipe tells you when). The submission webhook carries no app name or version, so the push uses your Expo project's slug.
12. EAS signs each request with `expo-signature` (HMAC-SHA1), but JustPush doesn't check that signature yet, so keep your endpoint 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
// Expo → EAS submission finished, errored or canceled
// Fires when EAS Submit finishes uploading a build to App Store Connect or Google Play,
// from a webhook created with `eas webhook:create --event SUBMIT`.
// Docs: https://docs.expo.dev/eas/webhooks/

// Where each platform's submission goes, and what to say once it's there.
const STORES = {
    ios: { name: "the App Store", next: "It's in App Store Connect now and will show up in TestFlight once Apple has processed it" },
    android: { name: "Google Play", next: "It's in the Google Play Console now, on the track your submit profile chose" },
}

// Final submission statuses and how loud to be.
const STATUSES = {
    finished: { emoji: "🚀", priority: 0 }, // a release milestone, worth knowing
    errored: { emoji: "❌", priority: 1 }, // needs you soon: the build didn't reach the store
    canceled: { emoji: "⏹️", priority: -1 }, // someone stopped it on purpose
}

// Look a key up in a table without tripping over inherited names like "toString".
function pick(table, key, fallback) {
    return typeof key === "string" && Object.prototype.hasOwnProperty.call(table, key) ? table[key] : fallback
}

// Treat blank or non-string values 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 }] : []
}

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

    // Guard: EAS sends no event header, so recognise a submission by its shape.
    // Build webhooks have buildDetailsPageUrl instead and are handled by expo/build.
    if (!body.submissionDetailsPageUrl && !body.submissionInfo) {
        console.log("Not an EAS submission webhook, skipping")
        return null
    }

    const status = pick(STATUSES, body.status, null)
    if (!status) {
        console.log(`Skipping EAS submission status "${body.status ?? "unknown"}"`)
        return null
    }

    // The submission payload has no app name or version, only the project's slug.
    const app = text(body.projectName) ?? "Your app"
    const store = pick(STORES, body.platform, { name: "the store", next: "Check the store's console for the new build" })

    const titles = {
        finished: `${status.emoji} ${app} submitted to ${store.name}`,
        errored: `${status.emoji} ${app} submission to ${store.name} failed`,
        canceled: `${status.emoji} ${app} submission to ${store.name} canceled`,
    }
    const messages = {
        finished: store.next,
        errored: text(body.submissionInfo?.error?.message) ?? "See the submission logs for details",
        canceled: "The submission was canceled before it reached the store",
    }

    return {
        title: titles[body.status],
        message: messages[body.status],
        topic: "Expo",
        priority: status.priority,
        buttons: [
            ...link(body.submissionDetailsPageUrl, "View submission"),
            ...(body.status === "errored" ? link(body.submissionInfo?.logsUrl, "Logs") : []),
        ],
    }
}
```

## Expo SUBMIT webhook payload (sample)

```json
{
  "id": "0374430d-7776-44ad-be7d-8513629adc54",
  "appId": "23c0e405-d282-4399-b280-5689c3e1ea85",
  "status": "errored",
  "platform": "android",
  "createdAt": "2026-09-24T10:15:32.822Z",
  "updatedAt": "2026-09-24T10:17:32.822Z",
  "archiveUrl": "https://expo.dev/artifacts/eas/example.aab",
  "accountName": "acme",
  "completedAt": "2026-09-24T10:17:32.822Z",
  "projectName": "acme-shop",
  "turtleBuildId": "8c84111e-6d39-449c-9895-071d85fd3e61",
  "submissionInfo": {
    "error": {
      "message": "Android version code needs to be updated",
      "errorCode": "SUBMISSION_SERVICE_ANDROID_OLD_VERSION_CODE_ERROR"
    },
    "logsUrl": "https://submission-service-logs.s3-us-west-1.amazonaws.com/production/submission_728aa20b-f7a9-4da7-9b64-39911d427b19.txt"
  },
  "cancelingUserId": null,
  "initiatingUserId": "7bee4c21-3eaa-4011-a0fd-3678b6537f47",
  "maxRetryTimeMinutes": 3600,
  "submissionDetailsPageUrl": "https://expo.dev/accounts/acme/projects/acme-shop/submissions/0374430d-7776-44ad-be7d-8513629adc54"
}
```

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