How it works

TheNotificationApp delivers push notifications to your iPhone via a single HTTP endpoint. No SDKs, no dashboards, no complex setup.

The flow

1. You make a POST request to the API with your app key and a JSON body
2. The API validates your key and payload
3. The notification is sent to Apple Push Notification service (APNs)
4. APNs delivers it to your iPhone instantly

One endpoint

Everything goes through one URL:

POST https://thenotification.app/api/sendNotification

Authentication

Authentication is done via a single header — your app key:

app_key: YOUR_API_KEY

You get an API key when you create an application in the iOS app. Each application has its own key, so you can separate notifications from different projects.

The notification payload

{
  "title": "Required — shown as the notification headline",
  "body": "Required — the notification message",
  "link": "Optional — URL that opens when the notification is tapped",
  "image": "Optional — image URL displayed in the notification"
}

Webhooks

If you don't want to call the API directly, you can use a webhook URL instead. Point any service that supports webhooks at your webhook URL and TheNotificationApp will convert the payload into a notification automatically.

Two webhook modes are available:

• Static webhook — fixed title, entire payload as body
• Dynamic webhook — extract specific fields from the payload

Privacy

Notifications are not stored. Once delivered to APNs, no record of the notification content is kept. Our servers are hosted in Switzerland and our services follow Swiss privacy law.

Limits

Plan	Notifications	Applications
Free	100 lifetime	3
Pro	1,000 / month	10

See rate limits for full details.