Widgets
Create Saved Form
Create a list-scoped public signup form
POST
Create Saved Form
Create and publish a saved form. The returned opaque
formId is a client-safe
public capability; the selected lists, tags, duplicate behavior, and success
action remain server-side.
Request
What happens when a contact who unsubscribed from all email submits this form
again.
reactivate resubscribes them and restores the form’s lists.
double_opt_in sends your double opt-in confirmation email first and
resubscribes them once they confirm. Turning on double_opt_in needs a double
opt-in confirmation email and a sender profile; otherwise the request returns
400. If the email or sender is removed later, returning unsubscribed
contacts stay unsubscribed until you fix it. When workspace double opt-in is
on, contacts always confirm first. duplicateStrategy never changes
subscription status.Run a Cloudflare Turnstile check before each signup. The hosted JavaScript
embed runs it, invisibly for most visitors. Signups that fail it, or come from
the plain HTML form snippet, which cannot run it, must confirm by email before
they are subscribed. Turning it on needs a double opt-in confirmation email
and a sender profile, otherwise the request returns
400. See Bot protection
frame.Heading copy: 1-180 visible characters, with up to 1,400 raw characters when
using inline HTML.
Description copy: up to 700 visible characters, with up to 4,000 raw
characters when using inline HTML.
Visual overrides:
accentColor, backgroundColor, textColor,
mutedTextColor, cardColor, borderColor (all #rrggbb), borderRadius
(0-32), headingFontFamily, bodyFontFamily, and density (compact,
balanced, or spacious). Omitted properties use the default theme.Confirmation shown when
redirectUrl is omitted. Up to 240 visible
characters, or 1,700 raw characters including inline HTML.