Sources
You can configure a number of Sources for notifications.
-
API Key
Mint a key for your scripts, apps, or integrations.
-
Email
A short email address that turns into notifications.
-
Heartbeat
Get notified when something doesn't happen but you expected it to.
-
Feed
Follow an RSS/Atom feed for new article notifications.
-
Webhook
Any service that can post a webhook can send to you.
-
Schedule
Reminders on a recurring schedule or on a specific date.
What's a Source?
A Source is how a notification enters your Prowl account. There are a few categories for how Sources behave:
- Sent to Prowl. For example, via the Prowl API, an incoming Webhook, or Email.
- Read by Prowl. For example, a Feed reads from another website to create notifications.
- Missed by Prowl. For example, a Heartbeat creates a notification when a ping isn't received.
- Triggered by time. For example, a Schedule occurs on a recurring basis or at a specific date and time.
Pause, resume, or remove a Source
A Source can be paused for a few reasons:
- You paused it yourself. Prowl will never automatically resume one you paused yourself.
- Your plan changed to allow fewer Sources. See plan limits and usage for more info.
- The Source finished. For example, a scheduled one-time notification, which cannot be resumed.
- Prowl paused a Feed that moved to a feed you already follow.
When paused, notifications from the Source are discarded rather than delivered. Prowl doesn't start returning errors to callers. For example, a Webhook will continue to return success. This is done to prevent configuration issues from temporary pauses: if a sender sees Prowl return that a webhook is invalid, it might indefinitely suspend calling that webhook, which would be undesirable.
Configuration history
Many Source types allow you to view or restore previous configurations. For example, a Webhook's configuration for how to map incoming requests or a Heartbeat's notification settings. Prowl stores the latest 20 configurations.
Plan limits and usage
Each plan limits how many Sources you can have, and how many notifications can be delivered each day. You can see your current plan and limits on account settings. The limit is based on active Sources. You can remove or pause a Source to free up a slot and allow either creating a new one, or resuming an existing paused Source.
Plan changes
If your plan ends or downgrades to fewer allowed Sources, Prowl will automatically pause your newest ones first. When you resume the plan or upgrade, those paused by this will be automatically resumed up to your new limit. Prowl will notify you when this happens so you're not surprised.
Daily notification limit
Your daily notification limit resets every day at midnight UTC. You can see the time until reset and current usage in account settings.