Notifications Overview
Channels and events that deliver UniPost alerts to humans. Email is ready to go, Slack and Discord need a webhook URL.
Email readySlack · Discord4 event typesDashboard-managed
Not the same as developer webhooks. If you need machine-to-machine delivery for post status or account events, use Developer webhooks. Notifications are dashboard-managed channels for people.
At a glance
| Question | Answer |
|---|---|
| Who is it for | Operators, on-call engineers, and founders who want human-readable alerts |
| Where to configure | Settings → Notifications |
| Channels ready today | Email, Slack, Discord |
| Events ready today | post.failed, account.disconnected, billing.usage_80pct, billing.payment_failed |
| Setup time | ~2 minutes per channel |
How setup works
1
Create a channel in UniPost
Open Settings → Notifications.
2
For Slack or Discord, create a webhook URL first
Use the Slack guide or Discord guide.
3
Paste the URL into UniPost
Add channel → Slack / Discord Webhook → paste.
4
Click Test
Confirm delivery before you trust production alerts to it.
5
Turn on events
Use the Subscriptions table to pick which alerts go where.
Supported channels
| Channel | Available | What you need | Format rule |
|---|---|---|---|
| ✓ | Nothing — UniPost uses your signup email automatically | — | |
| Slack webhook | ✓ | Slack Incoming Webhook URL | Must start with https://hooks.slack.com/ |
| Discord webhook | ✓ | Discord channel webhook URL | Must start with https://discord.com/api/webhooks/ |
| SMS | X | Modeled in backend only | — |
| In-app | X | Modeled in backend only | — |
Supported events
| Event | Severity | Default on | What triggers it |
|---|---|---|---|
post.failed | High | ✓ | A post could not be delivered to the target platform |
account.disconnected | High | ✓ | A connected social account lost access and needs to be reconnected |
billing.usage_80pct | Medium | ✓ | The workspace has reached 80% of its monthly plan quota |
billing.payment_failed | Critical | ✓ | A Stripe subscription payment failed |
New workspaces are subscribed to all four events on the auto-provisioned email channel by default.
Email is the default channel. UniPost creates it from your signup email automatically — there is nothing to add.
- Open Settings → Notifications
- Find the built-in Email channel showing your signup email
- Use Test if you want to confirm delivery
- Turn events on in the Subscriptions table
Current rule: UniPost only sends email to your signup email. You do not need to add it manually.
Subscribe to events
- Make sure the channel shows as Verified
- Scroll to the Subscriptions table
- Find the event — e.g.
post.failed - Tick the checkbox under the channel where the alert should land
Important: only verified channels appear in the subscriptions table.
Limitations
| Limitation | Reason |
|---|---|
| Email only delivers to your signup address | To keep the verified-identity surface simple — custom addresses are on the roadmap |
| SMS and in-app are not available yet | Modeled in backend but not wired to a provider |
| Webhook events are different from notifications | Use Developer webhooks for machine delivery |