Frequently Asked Questions
Find answers to common questions about Notilux, device pairing, notifications, and pricing.
Getting Started
Basic questions about Notilux and how to begin
What is Notilux? +
Notilux is a simple API that lets you send iOS push notifications from your backend. No APNs setup, no mobile app to build or maintain — just an API call.
How does Notilux work? +
Create an account, install the SDK, and generate a pairing link to connect your iPhone. From that point, a single API call sends a notification to the paired device.
Do I need to build a mobile app? +
No. Install the Notilux companion app on your iPhone once, pair it with your project using a link from the dashboard, and you are ready to receive notifications.
How long does setup take? +
Most developers send their first notification within five minutes. Create an account, install the SDK, pair a device, and send.
Device Pairing
Questions about connecting devices to your project
How does device pairing work? +
Call getPairingLink() with a user identifier. Share the link with the user. Opening it on their iPhone installs the companion app if needed, then pairs the device with your project.
What identifier should I use for pairing? +
Any stable string that maps to a user in your system — a user ID, an email address, or a UUID. Notilux uses it to route notifications to the right device.
How long are pairing links valid? +
Pairing links expire after one hour. For a permanent entry point, create a server-side endpoint that generates a fresh link on each request and redirects the user.
Can I pair multiple devices? +
Yes. You can pair multiple devices to the same user identifier and send notifications to all of them, or target a specific device.
Notifications
Questions about sending and managing notifications
What kinds of events is Notilux good for? +
Business events you want to notice quickly: new signups, support messages, payment completions, form submissions, or any custom event your backend emits.
Which languages and frameworks are supported? +
The official SDK targets Node and TypeScript. Notilux also exposes a plain HTTP API, so any backend that can make an HTTP request will work.
Can I send rich notifications? +
Yes. Notifications support a title, a body, and optional metadata you can use to deep-link or pass context to the companion app.
How is this different from Firebase or PagerDuty? +
Notilux is a lightweight developer convenience layer, not a critical alerting platform. There is no complex setup, no on-call scheduling, and no mobile SDK to maintain.
Authentication & Security
Questions about credentials and request security
How do I authenticate API requests? +
Use your client ID and client secret from the dashboard. The SDK picks them up from environment variables automatically, or you can pass them explicitly.
Are my credentials stored securely? +
Your credentials live in your own environment. Notilux never asks you to store secrets on our servers.
Can I rotate my credentials? +
Yes. You can generate new credentials from the dashboard at any time. Old credentials are invalidated immediately.
Pricing
Questions about costs and plans
Is there a free tier? +
Yes. The free tier includes a limited number of notifications per month, enough to get started and validate your use case.
How is pricing calculated? +
Paid plans are based on notification volume. The more notifications you send per month, the higher the tier.
Can I upgrade or downgrade at any time? +
Yes. Plan changes take effect immediately with no penalties.