Broadcasts
Send a single email to all (or filtered) affiliates. Plan limits and unsubscribe semantics.
A broadcast is a single email you send to the affiliates in your organization. Use it for product updates, new asset drops, promo announcements, or asking creators to push a fresh campaign.
Where to send broadcasts
/dashboard/broadcasts has the composer.
Form fields:
- Subject: 1-200 chars. No newlines or control characters (server-side validated against header injection).
- Body: 1-10000 chars. Plain text. Future release will add HTML composing.
- Campaign (optional): scope the broadcast to one campaign's affiliates. Leave blank for all affiliates in the org.
Click "Send". The composer shows a preview of recipient count before you confirm.
What recipients see
Each affiliate receives an email from notifications@mail.rekomi.com with:
- Your subject line
- Your body
- A
List-Unsubscribeheader (RFC 8058 one-click unsubscribe compliant) - A
Reply-To: support@rekomi.comheader (configurable) - The standard Rekomi-branded HTML wrapper
The List-Unsubscribe header means Gmail and Yahoo show a one-click "Unsubscribe" button. Clicking it adds the recipient to the global suppression list. They will not receive broadcasts from any organization on Rekomi going forward. Transactional emails (payouts, application status) still arrive.
Suppression list
Three things land an affiliate on the suppression list:
- They clicked List-Unsubscribe.
- Their email hard-bounced (typo, full inbox, mail server rejected).
- They marked an earlier broadcast as spam.
Suppressed recipients are silently filtered from your broadcast at send time. You do not get a delivery failure; you get a delivered count lower than your recipient count. The suppression list is global across organizations (we don't want different orgs spamming users who clearly want out).
Plan limits
Per-tier broadcast quotas (monthly, per recipient cap per broadcast):
| Tier | Monthly broadcasts | Max recipients per broadcast |
|---|---|---|
| Starter | 1,000 | 100 |
| Growth | 10,000 | 1,000 |
| Pro | 50,000 | 10,000 |
| Enterprise | unlimited | unlimited |
The composer enforces both limits at send time. If you exceed your monthly cap, the next broadcast is blocked with an HTTP 402 response and an inline error.
Suspended broadcasts
If your organization's bounce rate exceeds 5% on broadcasts, an automated watchdog (deferred, not yet shipped) will suspend broadcast sending and email you. Resume requires chatting with us. This protects domain reputation for everyone on mail.rekomi.com.
Rate limiting
Broadcast endpoint is rate-limited per user (10 sends per minute). The idempotency-key header (optional) allows safe retries if your dashboard tab loses connection mid-send; the same (orgId, idempotencyKey) returns the prior result within a 60-minute window.
Future: HTML compose, scheduled sends, segments
Three features on the deferred list:
- HTML composer with a WYSIWYG editor (today: plain text only)
- Scheduled sends (today: send-now only)
- Segment filters (e.g., "all affiliates who drove a sale in the last 30 days"; today: filter by campaign only)