Push notifications and webhooks

Moshi supports push notifications from two sources: custom webhooks and agent events from moshi-hook.

Enable push

Open Settings -> Push Notifications and turn notifications on. iOS may ask for system permission. If permission is denied, open iOS Settings and enable notifications for Moshi.

After registration succeeds, Moshi shows an API token in the settings screen.

Pause and resume

The notifications switch can pause Moshi delivery without deleting your token. Turn it back on when you want events to resume.

Test notifications

Use the test action in the notification settings screen to send a normal notification or an image notification. Test notifications are unavailable on the iOS simulator.

Webhook API

Use the copied token with Moshi's webhook endpoint:

$curl -X POST https://api.getmoshi.app/api/webhook \
$  -H "Content-Type: application/json" \
$  -d \'{"token":"YOUR_API_TOKEN","title":"Done","message":"Build finished"}'

This is useful from shell scripts, CI jobs, cron tasks, and agent prompts.

Agent notifications

For coding agents, prefer moshi-hook over hand-written webhook prompts. Hooks can distinguish approvals, turn completion, session starts, and tool activity without relying on the agent remembering to call curl.

Images

Webhook payloads can include image data when supported by the endpoint. In the app's test flow, Moshi sends a sample image URL so you can verify rich notification behavior.

Token handling

Treat the API token like a notification secret. Anyone with the token can send notifications to your device. If a token leaks, disable and re-register notifications from the app.