Broadcasts Overview
Send official notices to a contact list and track delivery, opens, clicks and bounces.
A broadcast is a single email sent to many recipients at once, such as a public notice, service update, county announcement, or stakeholder bulletin. Unlike the transactional send API, which sends one message at a time, a broadcast targets a whole contact list and rolls up the results.
Creating a broadcast
- Go to Broadcasts in the sidebar and click New broadcast.
- Choose the sending mailbox and the contact list to send to.
- Write the subject and the email content (HTML and plain text), or load a template.
- Save it as a draft, or schedule it for a future time.
Broadcast statuses
| Status | Meaning |
|---|---|
| Draft | Being edited; not yet queued. A broadcast with no scheduled time stays a draft. |
| Scheduled | Has a future send time set and will start sending automatically then. |
| Sending | Currently being delivered to recipients. |
| Sent | Delivery to all recipients has finished. |
| Cancelled | Stopped before or during sending. |
| Failed | The send could not be completed. |
You can edit a broadcast only while it is a draft or scheduled. You can cancel a broadcast while it is scheduled or sending; cancelling moves it to cancelled. A broadcast that is sending cannot be deleted - cancel it first.
Sending a broadcast
When you send a broadcast, Taifa Mail validates that a contact list is selected, that the list still exists and has at least one contact, and that a sending mailbox is chosen, is active, and sits on a verified domain. It then marks the broadcast as sending and hands the work to a background worker, which enumerates the list and queues one email per recipient. The HTTP request returns immediately, so even large lists send without timing out.
Tracking results
While and after a broadcast sends, the detail page shows aggregate counts for delivered, bounced, opened and clicked, plus a top links panel that ranks the URLs in your email by how many clicks each received.
Every recipient also becomes an individual entry in Email logs, tagged with the broadcast, so you can drill into any single send.
Recipients who are unsubscribed, have previously bounced, or are on your suppression list are automatically excluded from a broadcast.
Broadcasts vs. transactional email
| Broadcast | Transactional (send API) | |
|---|---|---|
| Audience | A whole contact list | One or a few recipients per call |
| Triggered by | You, manually or on a schedule | Your application, in response to an event |
| Typical use | Public notices, stakeholder updates, bulletins | Receipts, case updates, OTPs, service notifications |
| A/B testing | Yes - see A/B testing | No |