Email Marketing Plugin

Overview

The Email Marketing plugin adds a complete campaign management system to your Codapult project. Your users can build subscriber lists, create audience segments with flexible conditions, send broadcast campaigns with scheduling, and track opens and clicks — plus generate subject lines and email content with AI.

Package: @codapult/plugin-email-marketing · Price: $39 (one-time)

Install with:

npx @codapult/cli plugins add @codapult/plugin-email-marketing

Features

Subscriber Lists & Contacts

Manage subscribers across multiple lists:

• Contact management — CRUD operations on subscriber records with email, name, status, and metadata
• Status tracking — contacts can be subscribed, unsubscribed, bounced, or cleaned
• Source tracking — record how each contact was added (import, signup, API, manual)
• Bulk import — CSV upload for importing large contact lists
• Auto-sync — new users who sign up are automatically added as marketing contacts (via onUserCreated hook)
• Multiple lists — create separate mailing lists per product, audience, or purpose
• Default list — designate one list as the default for new contacts

Audience Segmentation

Build dynamic segments with rule-based conditions:

• Condition builder — filter contacts by status, source, metadata fields, and custom attributes
• JSON conditions — flexible, composable filter rules stored as JSON
• Segment preview — see how many contacts match a segment before using it in a campaign
• Campaign targeting — send campaigns to a specific list or segment

Broadcast Campaigns

Create and send email campaigns:

• Template-based — compose campaigns using reusable email templates
• List or segment targeting — send to an entire list or a specific segment
• Scheduling — send immediately or schedule for a future date/time
• Campaign lifecycle — draft → scheduled → sending → sent → cancelled
• Per-campaign stats — open rate, click rate, bounce rate, and delivery metrics
• Cancel support — cancel scheduled campaigns before they send

Email Templates

Reusable HTML templates for campaigns:

• Template editor — create templates with subject line, HTML body, and optional JSON content blocks
• Clone and customize — duplicate existing templates as a starting point
• Template library — manage templates per organization

Open & Click Tracking

Automatic engagement tracking for every campaign:

• Open tracking — invisible tracking pixel inserted in emails; records when a recipient opens
• Click tracking — links in emails are automatically wrapped; records when a recipient clicks
• Per-contact analytics — see which contacts opened and clicked per campaign
• Campaign-level metrics — aggregate open rate, click rate, and unique engagement counts
• Link management — tracked links stored per campaign with click counts

Suppression & Unsubscribe

Compliance and deliverability management:

• Global suppression list — bounced, unsubscribed, and complained addresses per organization
• Automatic enforcement — suppressed addresses are excluded from all campaign sends
• Unsubscribe links — included in all campaign emails automatically
• Reason tracking — record why an address was suppressed (bounce, unsubscribe, complaint)

AI Content Tools

Generate and improve email content with AI:

• Subject line generation — generate up to 5 subject line variants for A/B testing
• Content generation — create full email body content from a brief/description
• Content improvement — improve existing email copy while maintaining brand voice
• Generation history — all AI generations are stored for reference (type, prompt, result, accepted flag)

Analytics

Campaign and organization-level reporting:

• Campaign stats — opens, clicks, bounces, deliveries per campaign
• Org overview — aggregate metrics across all campaigns
• Engagement trends — track engagement over time

Dashboard Pages

The plugin adds 6 pages under /dashboard/email/:

API Routes

All routes are served under /api/plugins/email-marketing/. The plugin registers 35 API routes including:

• GET|POST|PUT|DELETE /contacts + POST /contacts/import + POST /contacts/unsubscribe — contact management
• GET|POST|PUT|DELETE /lists + POST /lists/contacts/add|remove — list management
• GET|POST|PUT|DELETE /segments + GET /segments/preview — segment builder
• GET|POST|PUT|DELETE /templates — template management
• GET|POST|PUT|DELETE /campaigns + POST /campaigns/send|schedule|cancel + GET /campaigns/stats — campaign lifecycle
• GET /track/open + GET /track/click — public tracking endpoints (pixel and redirect)
• GET|POST|DELETE /suppression — suppression list management
• GET /analytics/overview — org-level metrics
• POST /ai/subject-lines + POST /ai/content + POST /ai/improve — AI content generation

Database Tables

The plugin creates 10 tables prefixed with em_:

Environment Variables

Integration with Core Modules