The mailbox
1
It is connected, active and has a sender name
List your mailboxes with
GET /v1/accounts?channel=email. The one you send from needs isConnected and isActive both true. Give it a name too: it is the sender name your recipients see.2
A new mailbox sends less
dailyCapacity is the most emails a mailbox sends a day, from 1 to 15. A new mailbox starts at 15. Start one under 3 months old at 5:3
It is warming up
Warmup exchanges emails between your mailbox and others, so that mail providers come to trust it. It is free. Start it with
POST /v1/accounts/email/{accountId}/warmup, then read the mailbox’s warmup: its status, where the last 7 days of warmup emails landed, and dnsGrade, a grade for the domain’s mail setup. See Warm a mailbox up.4
It has a signature
{Sender Signature} in a step is filled in with the mailbox’s signature. Set it with the same PATCH call, as HTML.The list
1
The people can be reached
Readiness counts the people on the campaign’s lists, with and without a work email:An email-only campaign skips the people without an email. If
withoutEmail is high, enrich the list first.2
The people you must not write to are left out
Put your customers, your competitors and anyone else campaigns should never write to on a list, and exclude it from every campaign with
POST /v1/exclusions. Do it before you launch: an exclusion works when people are enrolled, and does not stop anyone already in a campaign. See Exclusions.A campaign can also skip people your campaigns already wrote to, with excludeContacted, and people who replied to one, with excludeEngagedContacts.The message
1
Every variable is filled in
Variable names are exact. A preview writes the step for the first person on the campaign’s lists. Nothing is saved or sent. See Template variables.
{Contact First Name} is a variable. {First Name} is not, and goes out as written, braces and all. Preview each step, and read the result for anything still in braces:2
A test email looks right in a real inbox
Send the first step to yourself:It is a real email and goes at once, from your first active mailbox. Check the subject, the sender name, the signature and how it reads on a phone. A test email carries no unsubscribe link and no tracking.
3
The unsubscribe link stays on
Every campaign email ends with a one-click unsubscribe link unless the campaign has
"addUnsubscribeLink": false. Leave it on. A send to someone who unsubscribed is refused. See Unsubscribes.4
Tracked links use your own domain
With click tracking on, links in your emails go through a link address. A tracking domain makes that address a hostname of your own, so people see your domain when they hover a link. Set it up before launch: it needs one DNS record, and usually becomes active within half an hour of the record being found.
Start small
- Cap the first days.
dailyEmailLimitis the most emails the campaign sends a day. Set it low for the first days, then raise it withPATCH /v1/campaigns/{campaignId}. - Send in working hours. A campaign sends from 9:00 to 17:00 in its
timezone, on itsemailDays. Settimezoneto where your recipients are. Left out, it is UTC. - Launch once. Send the launch with an
Idempotency-Key, so a retry cannot start it twice.
After you launch
- Read the queue.
GET /v1/campaigns/{campaignId}/queue?status=scheduledlists the messages waiting to go out, each with the text it will send. See Work the send queue. - Pause if something is wrong.
POST /v1/campaigns/{campaignId}/pausestops the campaign sending, and its queued messages wait. Launch it again to carry on. - Read the results.
GET /v1/campaigns/{campaignId}/statscounts the messages sent, the opens, the clicks and the replies. See Read the results.