Email Marketing
Email Marketing is the Mailtarget product surface for sending promotional and lifecycle campaigns to lists of contacts. It covers campaign authoring, recipient targeting, scheduling, sending, and reporting.
This is one of the two send paths Mailtarget supports. The other is the Transmission API, which targets one recipient at a time for transactional sends. Email Marketing is for one campaign reaching many recipients on a list.
Who uses Email Marketing
- Marketers compose campaigns in the dashboard, pick recipients via labels or segments, schedule sends, and review reports.
- Developers create, schedule, and send campaigns programmatically through
/v2/email-marketing/*endpoints. Same campaign objects, same delivery engine.
Both paths share the same data model and the same deliverability stack. A campaign authored in the dashboard can be triggered through the API, and a campaign created through the API appears in the dashboard list.
What a campaign contains
| Field | Description |
|---|---|
| Subject | The subject line. Supports substitution data and AI-assisted suggestions. |
| Sender | Sender name and verified from address. Must use a verified sending domain. |
| Body | HTML and plain-text body. Built with the visual editor (drag-drop components) or raw HTML. |
| Recipients | Contact list with optional include and exclude rules by label or segment. |
| Schedule | Send now, or schedule with optional Send Time Optimization. |
| Tracking | Open tracking, click tracking, heatmap data, link-level breakdown. |
| Category | Optional grouping. Used for reporting roll-ups across multiple related campaigns. |
The full request shape is in the Email Marketing API reference. Search for /v2/email-marketing to see the related endpoints.
Campaign lifecycle
draft -> scheduled -> sending -> sent -> reported
- Draft. Created but not sent. Editable.
- Scheduled. Send time set in the future. Cancellable up to send time.
- Sending. Platform is delivering. Not editable.
- Sent. Delivery to the platform complete. Recipient deliveries flow as webhooks.
- Reported. Engagement aggregates available. Reports continue to update for several days as opens and clicks come in.
How it relates to other Mailtarget surfaces
| Surface | Relationship |
|---|---|
| Transmission API | Same delivery engine. Different target shape: one recipient per send vs one campaign to many. |
| Mailtarget CDP | Provides the contact list, labels, segments, and funnel status that Email Marketing targets. |
| Sending Domains | The domain in from.email must be verified before a campaign can launch. |
| Webhooks | Delivery, open, click, bounce, complaint, unsubscribe events fire for every recipient. |
| Templates | Reusable bodies that campaigns can reference instead of inlining HTML. |
Where to start
| Goal | Read |
|---|---|
| Understand the campaign data model | Campaigns |
| Pick recipients with precision | Recipients |
| Schedule and time sends | Scheduling |
| Personalize per recipient | Personalization |
| Use the visual builder components | Components |
| Read campaign performance | Reports |
| Diagnose send failures | Deliverability |
| First end-to-end send | Compose and Send guide |
API surface at a glance
POST /v2/email-marketing # create draft
GET /v2/email-marketing # list campaigns
GET /v2/email-marketing/{id} # get one campaign
POST /v2/email-marketing/create-send # create plus send in one call
POST /v2/email-marketing/{campaignId}/send # send an existing draft
POST /v2/email-marketing/{campaignId}/cancel-schedule # cancel scheduled send
POST /v2/email-marketing/{campaignId}/duplicate # clone a campaign
POST /v2/email-marketing/{campaignId}/count-recipient # preview recipient count
GET /v2/email-marketing/{emailId}/preview # render preview
GET /v2/email-marketing/reports/basic # opens, clicks, bounces
GET /v2/email-marketing/reports/link # per-link breakdown
GET /v2/email-marketing/reports/open-time # opens by hour
GET /v2/email-marketing/reports/label # roll up by label
GET /v2/email-marketing/reports/export # async CSV export
Full reference: search the API Reference sidebar for "Email Marketing".
What this section does not cover
- Transactional sends keyed by user ID or event. Use the Transmission API.
- Push notifications and banners. Separate from Email Marketing. See the audience-channel docs.
- Mailtarget CDP funnel status updates. See Mailtarget CDP.