Newsletters

Newsletters let a Workspace create email campaigns, target subscribed recipients, send through configured sender accounts, and review delivery results.

Configure newsletters

The Workspace must have the newsletters feature enabled and your role needs newsletter permissions.
Open Workspace Settings -> Newsletters to maintain subscription lists, choose the signup mode, and check whether SMTP or Google Workspace senders are available. Configure sender accounts, sending-domain DNS verification, and domain identities under Workspace -> Email.
Choose whether public API newsletter signups subscribe immediately or require email confirmation before the address becomes eligible.
Review allowances and additional charges under Workspace Settings -> Usage.

Contact groups

Create contact groups from Contact Groups. Lists show member counts, and each detail page lets you switch between groups, edit metadata, add one active contact at a time, and remove existing members.
From the Contacts list, selected-row actions can add active contacts to an existing group or create a new group from the selection. Contact permissions control these actions and the group columns and filters, so groups remain available without the Newsletters feature.
Each group has a slug generated from its title. Public signup commands can add contacts to published groups by passing those slugs.
Archived contact groups disappear from campaign targeting and from the active group list.

Contact groups define which people a campaign considers. They do not grant newsletter consent.

Subscription lists are optional preferences such as Festival or Band news. Manage their recipient-facing name, description, subscriber count, and archive status under Workspace Settings -> Newsletters. Each list receives a generated slug, and a Workspace can have up to 200 active lists. Archiving retains existing memberships.

Every recipient still needs global newsletter opt-in. A campaign without a subscription list checks only global opt-in within its resolved audience. A campaign with a list additionally requires an active subscription to that list. Archived lists remain visible on existing campaigns but cannot be selected for a new campaign or used for sending.

Create a campaign

Open Newsletters, create a draft, and choose a starting template: Blank, Basic, or Einblick-style.
Use Campaign Settings to set the internal name, subject, preheader, sender identity, audience, and optional subscription list. The selected identity supplies the sender type, from address, from name, and reply-to address; these values are read-only in the campaign.
Build the email with newsletter blocks: container, heading, formatted rich text, image, button, divider, spacer, social media, columns, and unsubscribe.
Save editor changes explicitly with Save or Cmd/Ctrl+S. Sending saves dirty content first.

Double-click the campaign title in the editor header to rename it. If you close the editor with unsaved content, Einblick asks whether to save and exit, discard the changes, or keep editing.

Only draft campaigns are editable. Once a campaign is scheduled, sending, sent, cancelled, or blocked, the campaign content and audience become read-only.

Blank starts with an empty content container and an unsubscribe footer. Basic adds starter copy and a call-to-action button. Einblick-style adds a branded sample layout with a logo, banner image, two-column section, and footer.

The editor supports drag-and-drop layout, exact plain-text preview, desktop and mobile HTML previews, theme colors, fonts, spacing, and block styling. Columns can stack, stay side by side, or reverse on mobile; containers can use a background image with a solid fallback and optional dark overlay. The delivered HTML declares a light color scheme, while Inverted preview approximates clients that force color inversion anyway.

The social media block lines up profile links from a fixed icon catalogue — website, email, phone, RSS, and around 40 platforms. A username is enough; the full address is filled in. Each block chooses between brand colours and one custom colour, between a standalone icon and an icon on a shape (circle, rounded, or square), plus icon size, spacing, and alignment. Because email clients do not render SVG, the icons are delivered as PNG. LinkedIn, Slack, and Eventbrite are absent from the catalogue because their marks were removed from the icon collection in use.

Image blocks support alignment, links, explicit width and height, and cropping when both dimensions are set. They can use uploaded files, external URLs, or AI-generated images saved in the shared newsletter folder. Uploaded SVGs are converted to PNG copies for email compatibility, and the readiness check identifies missing alternative text, external image URLs, and remaining SVGs. Image generation uses Workspace AI limits; prompts can be up to 2,000 characters and generated files over 15 MB are rejected. Rich text supports formatting, links, lists, colors, font-size overrides, and recipient variables such as contact name, email, company, job title, phone, and unsubscribe URL.

Campaign detail and editing

Opening a campaign row shows its preview, status, sender, recipient counts, and a readiness checklist. Metadata, sender, and audience are maintained in Campaign Settings; the editor focuses on content and theme.
Draft campaigns send tests from the detail page. Other campaign states keep the content and audience locked.
Any campaign can be duplicated into a new draft with copied metadata, content, sender settings, and audience targets.
Campaigns in sending, sent, cancelled, or blocked state link to the analytics table.

Audience and opt-in

Campaign audiences can include individual contacts, contact groups, users, user groups, and organizations. Organization targets expand to the contacts linked to that organization.

The audience editor stores each target as a typed row. Contact group rows can also create a new group inline and add it to the campaign once it is saved.

Before queueing a campaign, Einblick resolves the audience and shows recipient counts:

Eligible recipients have a valid email, active global newsletter opt-in, and, when selected, an active subscription to the campaign's list.
Missing opt-in recipients have not subscribed yet.
Not subscribed to list recipients have global opt-in but not the selected list preference.
Unsubscribed, invalid, and duplicate addresses are excluded.

Only eligible recipients are queued for delivery. You can manage a contact's subscription from the contact detail page.

Contact imports can add contacts to groups and subscription lists and derive global consent from all rows or a column rule. The preview reports these audience changes. Imports send no confirmation email and preserve previous opt-outs, so import consent only when you can prove it.

Einblick checks eligibility again immediately before handing each email to the provider. A recipient who unsubscribes after the campaign starts is cancelled instead of receiving the email.

Grant the newsletters.signup write action to an API key before external forms can call the signup command.
The command accepts an email plus optional first name, last name, contact group slugs, subscription-list slugs in subscriptionLists, locale, and confirmation URL. At most 50 subscription-list slugs can be requested.
Einblick creates or updates the contact, adds it to matching published contact groups, and either subscribes immediately or returns pending_confirmation. An unknown or archived requested list, or an unknown group slug, fails the command.
The response returns the applied contact-group and subscription-list slugs alongside the contact, subscription, and signup status.
In double-opt-in mode, Einblick applies the requested subscription-list memberships after the confirmation link is opened. Confirmation tokens expire after seven days. A custom confirmationUrl must be an absolute http or https URL; it can include {token} or receive the token as a query parameter.

Send and schedule

Use Send test to send the current draft to a test address.
Use Send now to queue eligible recipients immediately.
Use Schedule to queue the campaign for a future date and local time. Scheduled campaigns can be cancelled before they start sending.
The send popover blocks campaigns without an audience or eligible recipients and saves dirty editor content before sending.
Choose a managed, SMTP, or Google Workspace sender identity in Campaign Settings. Managed identities use a verified newsletter domain or the Workspace fallback address; sender and reply-to values cannot be changed separately on the campaign.

Usage and limits

Einblick-hosted sending counts one delivered email to one address as one newsletter recipient. Queueing reserves the eligible count, then releases failed or blocked recipients so they do not consume usage. The allowance can warn, block further sending, or permit priced overage, depending on the Workspace plan. Workspace Settings -> Usage shows the current period, included amount, enforcement, estimated overage, and any monthly additional charge.

Analytics and unsubscribe

Open a campaign's analytics page to review accepted, delivered, bounced, complained, suppressed, acceptance-unknown, blocked, and cancelled deliveries. Acceptance unknown remains pending until delivery is resolved.
Each delivery row shows the recipient, source, status, attempts, last event time, and error message when available.
Newsletter emails include unsubscribe handling and list-unsubscribe headers. If the campaign content does not already contain the recipient's unsubscribe URL, Einblick appends a small unsubscribe footer.
An unsubscribe page links to the branded preference center for that recipient. They can change global newsletter consent and any active topic lists immediately; turning global newsletters off also disables every list.
Unsubscribing from a list-specific campaign removes only that list preference. Unsubscribing from a campaign without a list removes global opt-in and all list memberships. Future campaign previews show the applicable exclusion and omit the address from delivery.
With the managed sender, a previous permanent bounce, spam complaint, or provider suppression can suppress later deliveries before they reach the outbox. SMTP and Google Workspace senders do not yet use this pre-send suppression list. Provider-reported Suppressed deliveries count as failed.