Customize emails
Change the confirmation and welcome emails.
Each waitlist can restyle the confirmation email (and the welcome email's
frame) with structured fields, or replace the confirmation email with its own
HTML (settings.email.html, below).
Set them with PATCH /api/v1/waitlists/:id under settings.email.theme, or
in the dashboard ("Email" tab), which has an HTML editor with a preview.
| Field | Rules |
|---|---|
logo_url | https:// image on a named host, no credentials, max 2048. Shown at most 40px tall, alt text is the project name. |
accent_color | #rrggbb. Button color; the label turns black or white for contrast. |
background_color | #rrggbb. Behind the email card. |
text_color | #rrggbb, at least 4.5:1 contrast against the white card. |
button_text | Max 30, one line. |
button_radius | Integer 0 to 32 (px). |
heading | Max 80, one line. |
body_text | Max 1000. Blank lines separate paragraphs. Replaces the default paragraph. |
footer_text | Max 300, one line. Added above the mandatory footer. |
null clears a field; "theme": null resets everything. Empty means the
built-in look, byte for byte.
Placeholders
Only {{project_name}}, {{confirm_url}}, {{position}} and
{{referral_link}} work in the text fields. Any other {{...}} is rejected
with a 422 when you save. A placeholder with no value (for example
{{position}} in the confirmation email) renders empty.
Always included
The confirm button and link, the "Remove my email" link, your postal address and, on the free plan, "Powered by GetWait" cannot be removed by any setting. A plain-text version is always sent next to the HTML.
Saving and queued emails
Every change moves settings.email.theme.updated_at. The theme is read when
an email is rendered for sending, not when it is queued, so an email that is
queued but not yet sent uses the theme saved at send time. Emails already
sent never change.
Preview
The dashboard calls POST /api/v1/dashboard/waitlists/:id/email/preview
(session cookie, owner only, JSON body { "template": "confirm", "email": { "theme": {...} } }, 60 per minute per account). It returns { subject, html, text } for the unsaved theme with sample data and never sends mail.
It is a dashboard endpoint, so it is not part of the public OpenAPI spec.
"Send me a preview" sends the saved email to your own address (5 per hour,
counts toward the daily email quota).
Client notes
The layout is table based with inline CSS, 600px wide, and tested for the structure Gmail, Outlook and Apple Mail support. Rounded button corners degrade to square in Outlook desktop. Logos should be PNG or JPEG: SVG is blocked by Gmail and Outlook. The email declares a light color scheme, so clients that force dark mode may invert colors; pick a text color and background that still read when inverted. Some clients block remote images until the reader allows them, so the logo's alt text is shown instead.
Your own HTML
settings.email.html (max 20,000 characters) replaces the built-in
confirmation email body. It must contain {{confirm_url}}; {{project_name}},
{{position}} and {{referral_link}} are also filled in (values are escaped).
It overrides intro_text and theme for the confirmation email; null
returns to the built-in email.
The HTML is sanitized on every render, not only at save: only email-style
tags (tables, text, lists, links, https images) and a short list of inline
styles survive. Scripts, <style> blocks, forms, iframes, event handlers,
javascript: and data: links and CSS url() are removed. The remove link,
postal address and, on the free plan, "Powered by GetWait" are always added
below your HTML. A plain-text version is generated from it.