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.

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 Expo

Add it as a webhook for SUBMIT.

STEP 03

Get a push on your phone

With the text, sound and buttons from the recipe.

Setup

How to set up the Expo submit 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 your project's directory, run eas webhook:create and choose the SUBMIT event.
  3. Paste your webhook URL as the webhook URL.https://••••••••/•••••••• your personal URL, shown after install
  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"
  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.
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// Expo → EAS submission finished, errored or canceled
2// Fires when EAS Submit finishes uploading a build to App Store Connect or Google Play,
3// from a webhook created with `eas webhook:create --event SUBMIT`.
4// Docs: https://docs.expo.dev/eas/webhooks/
5
6// Where each platform's submission goes, and what to say once it's there.
7const STORES = {
8 ios: { name: "the App Store", next: "It's in App Store Connect now and will show up in TestFlight once Apple has processed it" },
9 android: { name: "Google Play", next: "It's in the Google Play Console now, on the track your submit profile chose" },
10}
11
12// Final submission statuses and how loud to be.
13const STATUSES = {
14 finished: { emoji: "🚀", priority: 0 }, // a release milestone, worth knowing
15 errored: { emoji: "❌", priority: 1 }, // needs you soon: the build didn't reach the store
16 canceled: { emoji: "⏹️", priority: -1 }, // someone stopped it on purpose
17}
18
19// Look a key up in a table without tripping over inherited names like "toString".
20function pick(table, key, fallback) {
21 return typeof key === "string" && Object.prototype.hasOwnProperty.call(table, key) ? table[key] : fallback
22}
23
24// Treat blank or non-string values as missing.
25function text(value) {
26 return typeof value === "string" && value.trim() ? value.trim() : null
27}
28
29// Only link to real http(s) URLs.
30function link(url, cta) {
31 return typeof url === "string" && /^https?:\/\//.test(url) ? [{ cta, url }] : []
32}
33
34function handleRequest(request) {
35 const body = request.body && typeof request.body === "object" ? request.body : {}
36
37 // Guard: EAS sends no event header, so recognise a submission by its shape.
38 // Build webhooks have buildDetailsPageUrl instead and are handled by expo/build.
39 if (!body.submissionDetailsPageUrl && !body.submissionInfo) {
40 console.log("Not an EAS submission webhook, skipping")
41 return null
42 }
43
44 const status = pick(STATUSES, body.status, null)
45 if (!status) {
46 console.log(`Skipping EAS submission status "${body.status ?? "unknown"}"`)
47 return null
48 }
49
50 // The submission payload has no app name or version, only the project's slug.
51 const app = text(body.projectName) ?? "Your app"
52 const store = pick(STORES, body.platform, { name: "the store", next: "Check the store's console for the new build" })
53
54 const titles = {
55 finished: `${status.emoji} ${app} submitted to ${store.name}`,
56 errored: `${status.emoji} ${app} submission to ${store.name} failed`,
57 canceled: `${status.emoji} ${app} submission to ${store.name} canceled`,
58 }
59 const messages = {
60 finished: store.next,
61 errored: text(body.submissionInfo?.error?.message) ?? "See the submission logs for details",
62 canceled: "The submission was canceled before it reached the store",
63 }
64
65 return {
66 title: titles[body.status],
67 message: messages[body.status],
68 topic: "Expo",
69 priority: status.priority,
70 buttons: [
71 ...link(body.submissionDetailsPageUrl, "View submission"),
72 ...(body.status === "errored" ? link(body.submissionInfo?.logsUrl, "Logs") : []),
73 ],
74 }
75}
Payload

The Expo SUBMIT webhook

This is what Expo sends to your URL for submit. It is a sample, trimmed to the fields recipes use.

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

Expo store submission 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 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.

Ready when you are

Expo on your phone in two minutes.

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