Email studio
Overview
The email studio takes the blank page away. It suggests ideas for your next mails — each with a category, a hook, a short overview and a recommended length — and turns an idea into a finished template in the block editor. Everything is written in the voice of your brand profile; without a profile the AI writes neutrally.
The studio sends nothing. It creates email templates that you refine in the editor and then use in a campaign or a dispatch.
You reach it through Email studio in the email templates and in dispatches.
Core tasks
Generate ideas. Generate ideas delivers several suggestions from brand profile and products; a focus (such as "autumn sale") steers them. Ideas stay until you use or dismiss them — a small stock for the coming weeks. Every idea carries an approach (such as "offer" or "problem and solution"), a preselected product — never a sold-out one — and a reason with the figures it is based on (units sold, revenue, margin, stock or the occasion). On top, suggestions on their own arrive every Monday and on occasions (Marketing → Goal & strategy → Autopilot); they are marked "On its own" or with the occasion.
Turn an idea into a mail. Create mail writes subject, preview text, heading, body and button and builds a template from blocks: header, content, unsubscribe note, footer. The idea then counts as used. With the AI off, the idea becomes a skeleton for you to fill.
Two versions with an image — as a test. An idea yields two versions by default (setting under Settings → Marketing → Studio variants, 1–3): each with its own subject, its own opening and its own image below the heading. Images are created without a click within the brand's automatic media budget — the idea's product photo is the reference — and appear in the template by themselves; for emails they are stored in the public store (mailboxes load images without signing in). If the budget is used up, the versions come without an image and the notice says so. Send as subject and content test creates a newsletter flow — inactive, with one message: version 1 is the template, version 2 runs against it in the split test (subject and content, test group 20 %, winner by clicks after four hours — changeable in the flow). You choose audience, time and start in the flow; subject and content of version 2 are read fresh when sending — an image finished later is included.
Web page → mail. Enter the address of a page — a product page, a blog post. The page is read through the secured outbound gateway, the button links to exactly this address. If the page cannot be reached, the mail is written from your brief, and the notice says so.
Variants. New versions of an existing template — same core message, each with its own subject and opening. Good for a split test.
Rebuild. Same structure and style as an existing template, but content from your brand profile — for instance to adopt a proven mail for another brand.
Translate. Choose a template and the target languages. The language versions then live in the same template; the send picks the recipient's language. Only block-editor templates are translated.
Fields in detail
The column What it does answers what changes in the system — not what the field is called. The grey name behind it is the API field: the same runs under it through automation and AI tools.
Create ideas and mails
| Field | Required | Values / format | What it does |
|---|---|---|---|
Brand brandId | no | one of your brands | Whose brand profile sets voice and content, and under which brand the template is created. |
Language locale | no | language code such as en | The language ideas and mails are written in. Empty = your language. |
Count count | no | 1–12 for ideas, 1–3 for mails and variants; from an idea 2 by default | How many suggestions are created at once. |
Focus focus | no | text | What the ideas should revolve around. Empty = the AI picks from profile and products. |
Channel channel | no | email (default), sms, whatsapp | Which channel the ideas are for. SMS and WhatsApp ideas live in the same store and appear in the SMS studio and the WhatsApp templates. |
Source source | yes (when creating) | idea, web page, variants, rebuild | What the mail is made from. |
Idea ideaUlid | for source idea | an open idea | The idea that becomes the mail. Afterwards it is used. |
Page address url | for source web page | https://… | The page the mail is made from. Addresses in the own network or without https are refused. |
Template templateUlid | for variants, rebuild, translate | an email template | The template to start from. When translating, exactly this one is extended. |
Brief brief | no | text | What the mail should also do, such as "with discount code AUTUMN" or "short and casual". |
Length length | no | short, medium, long | How much text the mail carries. Defaults to the idea's length. |
Target languages locales | when translating | list of language codes | Which languages to translate into. Only languages the system runs. |
Send as a test
| Field | Required | Values / format | What it does |
|---|---|---|---|
Versions templateUlids | yes | two templates of the same brand | Version 1 becomes the message template, version 2 variant B of the split test (subject and content). |
Name name | no | text | Name of the newsletter flow; without it the name of version 1. |
An idea
| Field | Required | Values / format | What it does |
|---|---|---|---|
Category category | — | promotion, knowledge, product focus, testimonials, story, news | What kind of mail the idea is. A mix keeps the list alive. |
Hook hook | — | text | Subject or core sentence of the idea. |
Overview overview | — | text | What the mail should say, in two or three sentences. |
Length length | — | short, medium, long | The recommended length. |
Status status | — | open, used | Used as soon as a mail was made from the idea. |
Settings & permissions
- Module
module.marketing, for everything with AI also the AI switched on. marketing.campaign.manage— use the studio.- Every AI request runs through the marketing rate limit and is billed like any AI use.
- Images of the versions run within the brand's automatic media budget (no extra permission); creating an image by hand
requires platform.ai_media.create.
- Through the API:
POST /v1/marketing/mail-studio/ideas,…/compose,…/split-test,…/translate; the ideas under
GET /v1/marketing/mail-ideas.
FAQ & troubleshooting
No ideas appear. The AI is off or returned no usable answer. The notice above the result says which.
The mail does not sound like us. Then the chosen brand has no brand profile or a very thin one. Maintain it under Content → Brand profile.
Translation cannot be selected. Only block-editor templates are translated; templates with custom HTML are not.