gabrielbbal10/notifyhub-api
Notification REST API — send via Email, SMS, WhatsApp, Slack, Telegram, Discord, Teams, and more.
Image
Integration & delivery
Message queues
0
793
gabrielbbal10/notifyhub-api repository overview
Short description:
Unified notification REST API — send via Email, SMS, WhatsApp, Slack, Telegram, Discord, Teams, Google Chat, Push, WebSocket, Twitter/X, LinkedIn, Notion. One Docker image, 14 channels.
Repository overview:
<p align="center">
<img src="https://raw.githubusercontent.com/GabrielBBaldez/notify-hub/master/docs/logo.png" alt="NotifyHub" width="150"/>
</p>
# NotifyHub API
Unified notification REST API with Swagger UI. Send notifications via **14 channels** — Email, SMS, WhatsApp, Slack, Telegram, Discord, Microsoft Teams, Google Chat, Firebase Push, WebSocket, Twitter/X, LinkedIn, and Notion — all from a single Docker image.
## Quick Start
```bash
docker run -d -p 8080:8080 \
-e NOTIFY_CHANNELS_EMAIL_HOST=smtp.gmail.com \
-e NOTIFY_CHANNELS_EMAIL_PORT=587 \
-e [email protected] \
-e NOTIFY_CHANNELS_EMAIL_PASSWORD=your-app-password \
-e [email protected] \
-e NOTIFY_CHANNELS_DISCORD_WEBHOOK_URL=https://discord.com/api/webhooks/... \
gabrielbbal10/notifyhub-api:0.7.0
Endpoints
| Method | Endpoint | Channel |
|---|---|---|
| POST | /send/email | Email (SMTP) |
| POST | /send/sms | SMS (Twilio) |
| POST | /send/whatsapp | WhatsApp (Twilio) |
| POST | /send/slack | Slack (Webhook) |
| POST | /send/telegram | Telegram (Bot API) |
| POST | /send/discord | Discord (Webhook) |
| POST | /send/teams | Microsoft Teams (Webhook) |
| POST | /send/google-chat | Google Chat (Webhook) |
| POST | /send/push | Firebase Cloud Messaging |
| POST | /send/websocket | WebSocket |
| POST | /send/twitter | Twitter/X (API v2) |
| POST | /send/linkedin | LinkedIn (REST API) |
| POST | /send/notion | Notion (API) |
Swagger UI
Open http://localhost:8080/swagger-ui.html for interactive API docs.
Usage Example (Python)
import requests
requests.post("http://localhost:8080/send/email", params={
"to": "[email protected]",
"subject": "Hello!",
"body": "Sent via NotifyHub API"
})
Links
- 🌐 Landing Page: gabrielbbaldez.github.io/notify-hub
- 📦 GitHub: github.com/GabrielBBaldez/notify-hub
- 🤖 MCP Image: hub.docker.com/r/gabrielbbal10/notifyhub-mcp
- ☕ Maven Central: central.sonatype.com/namespace/io.github.gabrielbbaldez
Tag summary
Content type
Image
Digest
sha256:8aa49bc2c…
Size
99.3 MB
Last updated
5 months ago
docker pull gabrielbbal10/notifyhub-api