Broadcasts Overview

A broadcast is a single email sent to many recipients at once - a newsletter, an announcement, a product update. 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

1. Go to Broadcasts in the sidebar and click New broadcast.
2. Choose the sender address and the contact list to send to.
3. Write the subject and the email content (HTML and plain text), or load a template.
4. Save it as a draft, or schedule it for a future time.

Broadcast statuses

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 the sender address (if set) is active. 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.

Broadcasts vs. transactional email