Notifications & Webhooks — SmartRTSP Documentation

Notification Channels

📳

Push Notification

iOS / macOS system notification while the app is running.

📧

Email (SMTP)

Send an email with a detection thumbnail via any SMTP server.

🔗

Webhook (HTTP POST)

POST a JSON payload to any URL on detection.

Push Notifications

Delivered via iOS/macOS UNUserNotificationCenter — instant, local, no server required.

1 Go to Settings → Notifications. Grant notification permission when prompted.
2 Select which events trigger notifications: Motion / Person / Vehicle / Fire / Smoke / Sound.
3 Tap a notification to deep-link directly to the recording clip.

Background required: On iPhone/iPad, notifications only arrive while SmartRTSP is running. Enable Background Monitoring to receive notifications when the app is in the background.

Email Notifications (SMTP)

Settings: Settings → Notifications → Email.

SMTP Server: e.g., smtp.gmail.com

Port: 587 (TLS) or 465 (SSL)

Username: Your email address

Password: App password for Gmail

Recipient: Where to send alerts

Gmail users: create an App Password at myaccount.google.com/apppasswords — do not use your regular Google password.

Webhooks

Settings: Settings → Notifications → Webhook.

Every detection event sends an HTTP POST request to your configured URL with a JSON body. Supports custom headers (e.g., Authorization tokens).

Example Payload

{
  "event": "person_detected",
  "camera": "Front Door",
  "timestamp": "2026-09-14T10:53:00Z",
  "confidence": 0.91,
  "thumbnail_url": "file:///var/mobile/.../snapshot.jpg",
  "recording_url": "file:///var/mobile/.../clip.mp4"
}

Retry logic: Failed webhook deliveries are retried up to 3 times with exponential backoff (5s, 30s, 2min).

Integration Examples

Home Assistant

Add a webhook trigger in Home Assistant automations. Use SmartRTSP's webhook URL as the trigger URL. Fires your automations on detection events.

ntfy.sh

Set Webhook URL to https://ntfy.sh/your-topic with Authorization: Bearer TOKEN header. Delivers push notifications to any device running the ntfy app.

Pushover

Point webhook to a Pushover gateway URL. Sends rich mobile push notifications via Pushover's service.

Make (Integromat) / n8n

Use the webhook URL from a Make or n8n scenario as the SmartRTSP webhook URL. Enables advanced workflows: Slack messages, Google Sheets logging, etc.