Overview
Campaigns
Campaigns send one email to the subscribers of your audiences and segments. Learn the requirements, statuses, credit cost and what the Campaigns list and API can do.
A campaign sends one email, such as a newsletter or a product announcement, to everyone subscribed to the audiences you choose, or to the contacts in the segments you choose. You build it in a wizard in the dashboard, test it, then send it right away or schedule it, and follow the results in its report.
Before you send
| Requirement | Why |
|---|---|
| Production access | New workspaces start in sandbox mode, where campaigns can’t be sent. Request access under WorkspaceSettingsRequests. See Production access. |
| A verified sending domain | The From email must use a domain you’ve verified in this workspace. See Add a domain. |
| An audience with subscribers | Campaigns send to audiences and segments, and only to contacts subscribed to at least one audience. Add people by hand, import them or collect them with a subscribe URL. |
| An unsubscribe link | Put {{unsubscribe_url}} in your content. See Unsubscribes. |
| Enough credits | Each campaign email costs 2 creditsCreditThe unit Emailit bills in. Each action costs a fixed number of credits, for example 1 for an API or SMTP email and 2 for a campaign email.. |
For loads and clicks to show up in the report, the sending domain also needs a verified tracking subdomain with Track loads and Track clicks turned on. Campaigns follow those domain defaults unless you override them in the Settings step of the wizard. See Tracking.
How it works
- Create the campaign. On Email MarketingCampaigns, select Add campaign and give it a name. Recipients never see the name.
- Work through the wizard: Recipients, Sender and Subject, Content, A/B test, Settings, Preview and test and Send. See Create a campaign.
- Send or schedule it. Emailit works out the recipients when sending starts and creates one email per recipient. See Test and schedule.
- Read the report. Deliveries, loads, clicks and unsubscribes appear on the campaign page as they happen. See Campaign reports.
What campaigns can do
| Feature | Learn more |
|---|---|
| Target audiences and segments, including by purchases and engagement, and exclude others | Create a campaign |
| Personalize with merge tags, conditional content, and, with Commerce (alpha), products, coupon codes and the cart | Merge tags, Products, coupons and the cart |
| Test up to five versions and send the winner by opens or clicks, or by orders or revenue with Commerce (alpha) | A/B testing |
| Skip recently emailed and unengaged contacts, add UTM parameters, tag campaigns | Sending options |
| Send all at once, throttled, at each recipient’s local time or at their best hour | Send strategies |
| Engagement by device and country, a click map, follow-ups to non-openers, and revenue and orders with Commerce (alpha) | Campaign reports |
Credits
A campaign creates one email per recipient, and each one costs 2 credits. A campaign to 10,000 subscribers uses 20,000 credits. Contacts skipped by smart sending or as unengaged don’t use credits. Credits come from your plan’s monthly included credits first, then from purchased credits. See Credits and pricing.
Campaign statuses
| Status | API value | Meaning |
|---|---|---|
| Draft | draft |
Being edited. Only drafts can be sent, scheduled or deleted. |
| Scheduled | scheduled |
Waiting for its send time. You can cancel the schedule up to 5 minutes before. |
| Testing | testing |
An A/B test went to the test group and Emailit is waiting to pick the winner. |
| In process | queued, sending |
Sending has started and Emailit is creating the recipient emails. With a spread send, until the last email goes out. |
| Sent | sent |
Every recipient email has been created and handed to delivery. Deliveries, loads and clicks keep updating afterwards. |
| Canceled | canceled |
The campaign was canceled with the API before it finished sending. |
| Archived | archived |
A sent campaign you’ve moved out of the way. Its report stays available. |
Status changes produce campaign.* events, such as campaign.scheduled, campaign.sending and campaign.sent, that you can receive with webhooks.
The Campaigns list
Email MarketingCampaigns lists your campaigns with tabs for All, Draft, Scheduled, In process, Sent and Archived. Canceled campaigns appear under All. Columns show the Name with the subject and tags, Status, Last updated, Created and Sent times, and Stats with the sent, clicked and unsubscribed counts and the revenue. Search matches the name and subject. Calendar opens a month view of scheduled and sent campaigns.
Selecting a draft opens the wizard. Selecting any other campaign opens its report.
The row menu offers these actions:
| Action | Available for | What it does |
|---|---|---|
| Rename | All campaigns | Changes the internal name. |
| Duplicate | All campaigns | Creates a new draft with the same sender, subject, content, sending domain, tags and sending options (smart sending, unengaged contacts and UTM parameters). The name defaults to the original name plus “ (Copy)“. Recipients, A/B tests and the send strategy aren’t copied, so pick audiences and segments again. |
| Save as template | Campaigns with content | Saves the content, subject and sender as a new template. |
| Cancel Schedule | Scheduled | Moves the campaign back to Draft. Not possible in the last 5 minutes before the send time. |
| Archive | Sent | Moves the campaign to the Archived tab. |
| Unarchive | Archived | Moves the campaign back to Draft. |
| Delete | Drafts | Deletes the campaign. This can’t be undone. |
Use the API
The Campaigns API covers the same lifecycle. It needs an API key with Full Access.
| Endpoint | Use it to |
|---|---|
| Create a campaign | Create a draft with name, subject, from_email, from_name, reply_to, html and text, plus the settings and an ab_test. |
| Update a campaign | Change the content or settings, or set recipients, a list of { "audience_id": "aud_…" } and { "segment_id": "seg_…" } objects, each with an optional "exclude": true. |
| Send or schedule a campaign | Send now, or pass a future scheduled_at to schedule a draft. Pick a send_strategy. |
| Retrieve campaign statistics | Read the counts and A/B results, and the revenue with Commerce (alpha). |
| Cancel a campaign | Cancel a draft or a campaign that’s still sending. |
| List, retrieve and delete | Read and clean up campaigns. Filter the list by status. |
You can use a campaign’s name instead of its cmp_ ID in the URL. Sending from a workspace without production access returns 403.