Sending & Testing

How do I create a sender / from address?

You do not pre-create senders in MailBlastr — any address on a verified domain works as a from. Use the Name <you@domain.com> format.

There is no separate "sender" object to create in MailBlastr. Unlike platforms that make you register and verify each individual from address, MailBlastr verifies at the domain level. Once a domain is verified, any address on it can be used as the from of an email or campaign — no extra setup per address.

How it works

  1. 1
    Verify your domain once

    Add your domain under Domains and publish its SPF/DKIM/DMARC records. See Managing domains.

  2. 2
    Pick any address on it

    After the domain is verified, hello@, receipts@, news@, support@, or any other mailbox on that domain is a valid from. You do not create them anywhere first.

  3. 3
    Send

    Put the address in the from field. MailBlastr checks the domain part is one of your verified domains and sends.

The from format

The from field accepts either a bare address or a friendly display name with the address in angle brackets:

Acme <hello@yourdomain.com>   ← display name + address (recommended)
hello@yourdomain.com          ← bare address

MailBlastr extracts the address from inside the <…> and checks that its domain (yourdomain.com) is verified for your account. A subdomain of a verified domain also works.

import { MailBlastr } from 'mailblastr';

const mb = new MailBlastr('mb_xxxxxxxxx');

const { data, error } = await mb.emails.send({
  "from": "Acme Support <support@yourdomain.com>",
  "to": ["customer@example.com"],
  "subject": "We got your message",
  "html": "<p>Our team will reply shortly.</p>"
});
console.log({ data, error });
If the from domain is not verified you get a validation_error: "The domain (…) is not verified." Finish domain verification before sending — there is nothing to create on the sender side.
The from address does not need to be a real, provisioned mailbox in another system — MailBlastr only checks that its domain is verified. That said, we recommend using an address that can actually receive replies (or setting reply_to) so recipients aren’t writing into a void.
Want replies to go somewhere other than the from? Set reply_to (a Reply-To header). The from still controls which verified domain the mail is sent from.