Campaign Monitor

Campaign Monitor

Campaign Monitor is an email marketing platform for building and sending campaigns to subscriber lists.

Data Model

• Clients — top-level partitions (agency model). Every list, campaign, subscriber, segment, and template belongs to a client. Always resolve a client_id first.
• Lists — subscriber containers within a client. Each has a title, opt-in confirmation settings, and unsubscribe behavior.
• Subscribers — contacts on a list, keyed by email address. Support custom fields, consent-to-track, and mobile number. Upsert uses email as the natural key (same email = update, new email = create).
• Segments — dynamic audience slices within a client based on subscriber data or behavior.
• Campaigns — email sends within a client. Lifecycle: create draft → send preview → send. Reports are available after delivery.
• Templates — reusable email layouts within a client. Campaigns can reference a template at creation.
• Tags — labels for organizing subscribers or campaigns within a client.
• Suppression lists — per-client lists of email addresses that are permanently excluded from sends.
• Admins — account-level administrators (not scoped to a client). Keyed by email address.

Typical Workflow

1. List clients (no params) → pick a ClientID.
2. The ClientID scopes subsequent reads/writes for lists, campaigns, segments, templates, tags, and suppression entries.
3. A list_id (from step 2) scopes subscriber operations — add, update, unsubscribe, or delete.
4. Sending a campaign: create a draft (needs ClientID + list_ids + html_url or template), optionally send a preview, then send.

Key Behaviors

• Pagination: List endpoints for campaigns, subscribers, and suppression lists return paginated results with PageNumber, PageSize, TotalNumberOfRecords. Default page size is 1000.
• Unsubscribe vs Delete: Unsubscribe is a soft removal (subscriber stays on the list as unsubscribed). Delete is permanent removal from the list.
• Admin tools are account-level: Getting, creating, updating, or deleting admins does NOT require a client_id. Admins are keyed by email address.
• Campaign deletion: Only draft campaigns can be deleted. Sent campaigns are permanent.