# [[Apprise]]
_Created: 2025-10-06_ | #apprise | [[010 System Administration MOC|System Administration]]
A single, lightweight Python toolkit and CLI that fans one message out to 100+ services (Discord, Telegram, Slack, SMS, email, webhooks, more) with one simple, unified syntax.
- **Homepage**: [Github](https://github.com/caronc/apprise), [Wiki](https://github.com/caronc/apprise/wiki)
- **See also**: [[Mailrise]]: An SMTP to Apprise gateway
## Notification docs
| Provider | Note |
| --------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| [Pushover](https://github.com/caronc/apprise/wiki/Notify_pushover) | URL is of the format `pover://{user_key}@{token}` in its simplest. Variations exist to set priority, deviceid, even sounds and retry options |
| [Discord](https://github.com/caronc/apprise/wiki/Notify_discord) | `discord://webhook_id/webhook_token` |
| [JSON Post](https://github.com/caronc/apprise/wiki/Notify_Custom_JSON) | You can post the notification to a webserver |
| [HTTP Form Post](https://github.com/caronc/apprise/wiki/Notify_Custom_Form) | You can submit a `application/x-www-form-urlencoded` form. |
### SMTP
[Docs](https://github.com/caronc/apprise/wiki/Notify_email)
URL is generally the format `mailtos://userid:
[email protected]` (Port 587) or `mailtos://domain.com:465?user=userid&pass=password`
Apprise has automatic configuration for a bunch of providers that lets you skip mentioning the precise SMTP server for these providers.
- For example, using `mailto://{user}:{password}@gmail.com` will automatically use the SMTP server `smtp.google.com`
- The [Fastmail plugin](https://github.com/caronc/apprise/wiki/Notify_email-Fastmail) specifically recognizes 116 Fastmail domains!
- Sendgrid lets you specify the validated domain: `mailto://{user}:{password}@sendgrid.com?from=noreply@{validated_domain}`
For custom domains and mail servers, the URL is a bit different. e.g. Fastmail SMTP authentication requires something like this:
`mailtos://
[email protected]&pass=app-password&smtp=smtp.fastmail.com`
You can also add parameters: `&from=user@domain` (for setting the Reply-To) and `&to=recip1@domain,recip2@domain` (not generally required)
## Notification Types
Apprise supports the following [notification types](https://github.com/caronc/apprise/wiki/Development_API#message-types-and-themes): `info`(default), `success`, `warning`, `failure`