# 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.

**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:

1. **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](https://thelastapi.dev/blog/send-transactional-email-no-dns).
2. **Marketing email** sends from `hello@news.<slug>.vibiz.app` or `news.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:

```bash
vibiz email setup
```

This 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.

```bash
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](https://thelastapi.dev/blog/business-inbox-own-domain). Once verified, set `from_domain` to your domain in the email settings. For full details on DNS verification, consult the [Email documentation](https://thelastapi.dev/docs/email).

## 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_html` into 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.upsert` from your backend.

Here is how to add or update contacts from a server-side app using `@vibiz/app`:

```ts
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:

```ts
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:

```bash
vibiz email contacts import audience.csv --dry-run
```

Always 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](https://thelastapi.dev/blog/import-newsletter-list-csv).

## 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:

```bash
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.md
```

Inside `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:

```bash
vibiz email broadcast review brd_123
```

The 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:

```bash
vibiz email broadcast test brd_123 --to owner@example.com
```

### 4. 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.

```bash
vibiz email broadcast send brd_123
```

To 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):

```bash
vibiz email automation create --file onboarding.json
vibiz email automation activate aut_123
```

When building automated workflows, pair your email sequences with monitoring to [know when your site goes down, a deploy fails or sales stop](https://thelastapi.dev/blog/know-when-your-site-goes-down), 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.

---

Published 2026-11-15 · https://thelastapi.dev/blog/newsletter-tool-small-business
