Push notification did not arrive

First open Agent Approve and check whether the request or completion is already in the app.

Notifications are required for the normal background workflow. Without permission, Agent Approve can receive an item through its live connection while the app is open, but iOS will not alert you after the app moves to the background.

The item is in the app

1. Open iOS Settings > Notifications > Agent Approve.
2. Turn on Allow Notifications and choose the alert styles you want.
3. Check Focus modes and Scheduled Summary for delayed alerts.
4. Open Agent Approve once after reinstalling the app or changing notification permission.
5. Send another harmless test request.

If an Apple Watch is paired, iOS may deliver the alert to the watch instead of showing it on the iPhone you are using.

The item is not in the app

This is not only a push problem. Run npx agentapprove status, confirm the integration is installed, and follow No approval appears on the phone.

For completion alerts, confirm Settings > Notifications > Agent Completion is on. For follow-up prompts, confirm Voice Follow-up is on and the integration supports follow-up input.

The app was closed and no alert came

Each time the app opens, it confirms with the service that this device can receive push notifications. On a cold launch that confirmation takes a few seconds. Before September 2, 2026, quitting the app inside that window could leave the device marked not ready, and the service then skipped the push for every request until the next time the app opened. The service no longer lets that brief state override a device it has already verified.

If requests still arrive without alerts:

1. Open the app and leave it in the foreground for a few seconds.
2. Send another harmless test request with the app closed.
3. If alerts still do not arrive, follow the notification permission steps above.

A device keeps failing after switching apps or reinstalling

If you moved between the App Store build and a TestFlight build, or reinstalled the app, a device can hold an outdated push identity. It shows requests while open but never receives alerts, and other devices on the same account are unaffected. Delete the app from that device, reinstall it, sign in, and open it once. See Pairing or token expired if the device also needs to pair again.