What is notfs?

notfs is a push notification platform built for developers. It lets you send push notifications to your iPhone with a single API call — using curl, Python, JavaScript, or any HTTP client.

Why notfs exists

Developers need a way to get notified about events that matter: build failures, server alerts, deployment completions, cron job results, and security events. Existing solutions are either too complex (setting up Firebase Cloud Messaging or Apple Push Notification service directly), too limited (Pushover lacks scheduling and webhooks), or not developer-focused (Pushbullet is consumer-oriented).

notfs gives you a clean REST API, a native iOS app, and everything you need to integrate push notifications into your developer workflow — in under a minute.

How it works

  1. Create an account — Sign up at notfs.dev or via the API. Get a JWT token instantly.
  2. Create an API key — Generate keys with scoped permissions (notifications:read, notifications:write, devices:read, devices:write).
  3. Install the iOS app — Download notfs from the App Store, sign in, and allow push notifications.
  4. Send a notification — POST to the API with your title, body, and optional scheduling, sound, and priority settings.
curl -X POST https://api.notfs.dev/api/notifications \
  -H "X-API-Key: ntfs_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Deploy complete",
    "body": "v2.4.1 is live on production",
    "priority": "high",
    "delay": "5s"
  }'

Key features

  • Simple REST API — Send notifications with a single POST request. API key or JWT authentication.
  • Scheduled delivery — Schedule notifications for 5 seconds to 24 hours in the future, or use exact ISO 8601 timestamps.
  • Custom sounds — Choose from default, soft, or critical alert sounds. Add custom sounds to your app bundle.
  • Priority levels — Low, normal, high, and critical. Critical notifications bypass Do Not Disturb.
  • Webhooks — Get HTTP callbacks when notifications are delivered or fail. HMAC-SHA256 signature verification.
  • API key scoping — Create keys with specific permissions. Limit what each key can access.
  • Multi-device support — Send to all devices or target a specific one.
  • Native iOS app — Beautiful dark-mode app with notification creation, history, device management, and API key management.
  • Delivery tracking — Every notification is tracked: SCHEDULED → QUEUED → DELIVERED or FAILED.
  • Analytics — Track delivery rates, failure reasons, and notification volume.

Who uses notfs

  • Backend developers who want to get notified about server events, cron job results, and deployment status.
  • DevOps engineers who need instant push alerts for infrastructure incidents.
  • Indie developers who want to monitor their side projects without complex alerting infrastructure.
  • Teams who need reliable push notifications for CI/CD pipelines and production monitoring.

Common use cases

  • CI/CD build notifications (GitHub Actions, GitLab CI, Jenkins)
  • Server monitoring alerts (CPU, disk, memory, service health)
  • Cron job failure notifications
  • Deployment status updates
  • Security alerts (SSH logins, failed auth attempts)
  • Long-running script completion (ML training, data migrations)
  • Webhook relay (Stripe payments, GitHub events, Shopify orders)
  • Uptime monitoring
  • SSL certificate expiration warnings
  • Custom automation and alerting

Pricing

notfs has a generous free tier: 1,000 notifications per month, 3 devices, 3 API keys, scheduling, custom sounds, webhooks, and analytics — all free, forever.

The Pro plan at $5/month adds unlimited notifications, unlimited devices, unlimited API keys, priority delivery, webhook delivery logs, and priority support.

Technical details

  • API base URL: https://api.notfs.dev
  • Authentication: API key (X-API-Key header) or JWT Bearer token
  • Rate limits: 100 requests/min, 60 notification sends/min
  • Supported platforms: iOS 17+
  • API documentation: https://api.notfs.dev/docs (Swagger/OpenAPI)
  • Delivery method: Apple Push Notification service (APNs) via HTTP/2
  • Stack: Node.js, PostgreSQL, Redis, Docker

Getting started

Send your first push notification in under a minute. Sign up, create an API key, install the iOS app, and make your first API call.