Dashboard Composer
Send one-off emails, broadcasts, and transactional API examples from the Taifa Mail compose page.
The Compose page (/compose) is the dashboard send hub. It has three tabs:
| Tab | Purpose |
|---|---|
| One-off | Send a single email (or a small typed recipient list) through an allocated mailbox. |
| Broadcast | Draft a notice to a whole audience list (same flow as Broadcasts → New). |
| Transactional | Live code snippets (cURL, Node, Python) for the REST API, scoped to an API key you pick. |
All sends go through the same backend pipeline as the REST API.
One-off tab
Selecting a sender
Use the From dropdown to choose an allocated mailbox. Only active mailboxes on verified domains appear. To get a new mailbox, see Request domains & mailboxes from ICTA.
Adding recipients
Type email addresses into the To field. Press Enter, comma, or space to add each address. Click Add Cc or Add Bcc to expand those fields.
To send to an entire contact list with variants and live preview, use the Broadcast tab or go to Audiences → Send to list (which opens Broadcasts → New). For programmatic list sends, see Batch & list sends.
Subject line
Enter the subject in the Subject field. Keep it concise for deliverability.
Email body
The One-off tab uses a single plain-text area. Write normally: Taifa Mail wraps each paragraph in <p> tags and sends a multipart message with both text and HTML. You do not need to author raw HTML here.
Drag files onto the body area or click Attach a file to include attachments (3 MB max per file).
Options
| Option | What it does |
|---|---|
| Schedule | Pick a date and time (2 minutes to 30 days ahead) instead of sending immediately. |
| Track opens | Enable open tracking for this send (on by default). |
| Save draft | Persist the message under Drafts (auto-save also runs while you type). |
A Spam score indicator in the footer estimates deliverability risk as you compose.
Send
Click Send (or Schedule when a time is set). A success toast confirms the message was queued.
There is no separate preview panel or template loader on this page: use Email templates from Broadcasts or load a saved draft from Drafts instead.
Broadcast tab
Pick an audience list, set an internal broadcast name, choose a sender mailbox, and compose the notice. This mirrors Broadcasts → New: scheduling, HTML body, and per-list variant support live there rather than inline on Compose.
Transactional tab
Pick an API key and copy ready-made snippets for POST /v1/emails. Use this tab when integrating a backend service; it does not send mail itself.
Code mirror
On large screens, a code mirror panel on the right shows the equivalent REST request for your current One-off draft. Toggle it with Show code mirror.