A newsletter tool for a small business: contacts, lists and broadcasts
thelastapi provides a small business newsletter tool with contact management, segmentation, and broadcasts for $0.001 per email.
On this page 8 sections
thelastapi includes a complete newsletter tool for small businesses that handles subscriber contacts, lists, automations, and broadcast sending for $0.001 per email. Marketing mail runs on dedicated addresses—either hello@news.<slug>.vibiz.app or your own subdomain like news.yourcompany.com—so marketing campaigns never endanger your transactional mail reputation. You can run newsletters entirely from the web console, script them with the vibiz CLI, or connect your customer database directly with the @vibiz/app library.
Whether you run a software product, an e-commerce shop, or a local service, keeping in touch with subscribers should not require managing five separate dashboards or paying expensive monthly platform fees. Here is how contact management, list segmentation, and email broadcasts work in thelastapi.
Why keep marketing email separate from transactional email?
When you send an order confirmation, a receipt, or a password reset, delivery cannot fail. Transactional mail requires near-perfect inboxing, which depends on a clean domain reputation.
Marketing broadcasts behave differently. Even with an opt-in list, people change email addresses, inboxes go stale, and occasionally subscribers mark a message as spam instead of unsubscribing. If both types of email share one domain and one sending reputation, a single poorly received marketing campaign can trigger rate limits or pauses that stop your login links from arriving.
thelastapi isolates the two:
- Transactional email sends from
<mailbox>@<slug>.vibiz.app(or your primary mailbox). If you only need to trigger order updates, see how to send transactional email from your app without touching DNS. - Marketing email sends from
hello@news.<slug>.vibiz.appornews.yourcompany.com. It maintains its own domain records, IP pools, and reputation metrics.
If high bounce rates ever pause marketing broadcasts, transactional delivery continues unaffected.
Setting up your sender identity and compliance
Starting with marketing email requires two configuration steps: preparing the mail domain and supplying your physical business address.
Run the setup command from your terminal:
vibiz email setupThis registers the marketing resource and verifies the sending domain within minutes. Under United States CAN-SPAM regulations and global spam laws, commercial emails must include a valid physical postal address and a working unsubscribe mechanism. thelastapi enforces this in software: broadcasts cannot be sent until an account owner adds a postal address.
vibiz email settings set \
--from-name "Acme Support" \
--reply-to "hello@acme.com" \
--postal-address "1 Main St, Springfield, IL 62701, USA"You can also send broadcasts from your own custom domain, such as news.yourcompany.com. To do this, first configure a mailbox for your domain as explained in our guide to a business inbox at your own domain: hello@yourcompany.com. Once verified, set from_domain to your domain in the email settings. For full details on DNS verification, consult the Email documentation.
Collecting and managing contacts
Every person you email is stored as a contact record containing their email address, first and last name, custom properties, list memberships, and consent tracking.
Collecting subscribers
You can collect subscribers through three built-in methods:
- Hosted signup form: Every project receives a hosted form page at
form.url, which you can link directly from social profiles or documentation. - Embedded HTML snippet: Copy
form.embed_htmlinto any website. It is plain HTML without external scripts, styled to fit your site. - Direct API or SDK submissions: Accept signups in your existing forms and post them directly to the form URL or run
vibiz.contacts.upsertfrom your backend.
Here is how to add or update contacts from a server-side app using @vibiz/app:
import { vibiz } from '@vibiz/app';
await vibiz.contacts.upsert({
email: 'ana@example.com',
first_name: 'Ana',
lists: ['Newsletter'],
properties: { plan: 'pro', trial_ends_at: '2026-04-01' },
consent: { method: 'app_signup', text: 'Send me product updates' },
});If a contact previously unsubscribed, upserting their record will not quietly re-subscribe them. Their status becomes pending and thelastapi sends a confirmation email. Only clicking the confirmation link restores their subscribed status.
Segments and event tracking
Lists are static groups (such as Newsletter or Beta), while segments are dynamic filters evaluated at send time. You can filter by contact properties, list membership, past broadcast engagement, or tracked product events.
To record user actions from your app:
await vibiz.contacts.track('ana@example.com', 'upgraded', { plan: 'pro' });You can then build a segment targeting contacts who triggered upgraded within the last 30 days, or contacts who have not opened an email in 90 days.
Importing existing lists
If you are migrating from another service, you can import your CSV export. thelastapi parses standard exports from Mailchimp, Substack, beehiiv, Kit, MailerLite, Buttondown, Ghost, EmailOctopus, and Loops without reformatting:
vibiz email contacts import audience.csv --dry-runAlways run imports with --dry-run first. The report identifies formatting issues, role-based addresses (info@, sales@), throwaway inboxes, and typos (such as ann@gmial.com). To learn how the hygiene pipeline screens contacts, read our guide to import a newsletter list from CSV, safely.
Composing and sending a broadcast
A broadcast is a one-off email sent to an entire list, a segment, or every subscribed contact.
1. Write the message
You can draft your broadcast in plain text, Markdown, or custom HTML. thelastapi supports buttons, images, code blocks, and dynamic merge tags with fallback values:
vibiz email broadcast create \
--name "April Newsletter" \
--subject "What we shipped in March" \
--preview-text "New database branching, faster builds, and lower fees." \
--list "Newsletter" \
--file newsletter.mdInside newsletter.md, use tags like Hi {{{FIRST_NAME|there}}} or {{plan|starter}}. A contact without that property automatically receives the fallback text.
2. Review and pre-flight checks
Before any broadcast leaves the queue, the review engine runs automated safety checks. You can inspect the review in the console or CLI:
vibiz email broadcast review brd_123The pre-flight engine evaluates several criteria:
| Check | What it inspects | Why it matters |
|---|---|---|
| Postal Address | Verified business address present in footer | Legal compliance (CAN-SPAM) |
| Message Size | Total HTML size below 102 KB | Gmail clips messages larger than 102 KB, hiding unsubscribe links |
| Merge Tags | Every tag has a fallback value | Prevents broken greetings like "Hi null" |
| Links | Verifies HTTPS and flags localhost URLs | Catches accidental draft links |
| Credit Balance | Sufficient balance held for all recipients | Prevents partial sends from credit exhaustion |
3. Send a test copy
You can send a free test email to project owners before scheduling the full campaign:
vibiz email broadcast test brd_123 --to owner@example.com4. Sending and automated pacing
When you send or schedule a broadcast, the recipient count multiplied by $0.001 is held from your credit balance. If you cancel before completion, unused credits are released immediately.
vibiz email broadcast send brd_123To protect deliverability across the platform, broadcasts to contacts you have never emailed before go out in graduated stages: a random 2% batch, then 5% more, then the remainder in 30-minute intervals while bounce and complaint rates remain low. Contacts you have emailed before send at normal speed.
If hard bounces exceed 2.5% or spam complaints exceed 0.08%, the broadcast pauses itself automatically, flags the reason, and sends an email notification to the account owner. Once invalid addresses are cleaned, the owner can resume the campaign.
Pricing and system limits
thelastapi uses straightforward usage-based pricing with no recurring monthly tier upgrades:
| Feature | Limit / Rate | Notes |
|---|---|---|
| Marketing Sends | $0.001 per delivered contact email | $1.00 per 1,000 sent emails |
| Contacts & Lists | Free | Store unlimited contacts and properties |
| CSV Imports & Tests | Free | Up to 100,000 rows (15 MB) per CSV |
| Daily Sending Ramp | 500 emails on Day 1 | Doubles each clean day up to 100,000/day |
| Attachment Size | 15 MB per file, 20 MB per message | Managed via inbox mailboxes |
| Machine Filtering | Built-in | Security bots and scanner clicks removed from stats |
Every broadcast includes comprehensive delivery statistics: delivered, opened, clicked, bounced, complained, and unsubscribed. Bot clicks and corporate security link scanners are filtered out automatically so your open and click percentages reflect real readers.
Automations for recurring sequences
Beyond one-off broadcasts, you can configure event-driven sequences for onboarding or re-engagement. Automations support wait steps, conditional branches based on whether a recipient opened a prior step, and exit events when a subscriber completes an action (like upgrading their account):
vibiz email automation create --file onboarding.json
vibiz email automation activate aut_123When building automated workflows, pair your email sequences with monitoring to know when your site goes down, a deploy fails or sales stop, ensuring customer-facing systems stay healthy while your campaigns run.
Next steps
To set up your newsletter, initialize an email-enabled project with vibiz init mailer --resources email or add email to an existing directory using vibiz add email. Then run vibiz email setup to prepare your sending identity.
Frequently asked questions
How much does sending a newsletter cost with thelastapi?
Marketing broadcasts cost $0.001 per sent contact email ($1.00 per 1,000 emails), deducted from your account credits. Managing contacts, creating segments, importing lists, and sending test emails to owners are completely free.
Can an AI agent send a newsletter broadcast on my behalf?
By default, sending a broadcast or activating an automation requires owner approval (`403 owner_only`), and the CLI provides a console review link for the owner to confirm. However, an owner can grant agents permission to send up to a specific monthly volume by configuring `--agent-limit` in the marketing email settings.
What happens if my email list contains inactive or invalid addresses?
thelastapi screens CSV imports for role-based emails, syntax typos, disposable inboxes, and known bounces. If an active broadcast exceeds 2.5% bounces or 0.08% spam complaints, sending pauses automatically so you can clean the remaining audience without damaging your domain's reputation.