Newsletter
Design a signup card once, embed it anywhere, and grow one tenant-wide subscriber list - no separate list per site or campaign tool to wire up.
Overview
The Newsletter service gives you:
- A visual signup-card builder - colours, corners, headline and button text, with a live preview.
- A browser-embed widget that drops the card on any HTML page with one
<script>tag. - A server-to-server subscribe API for backend integrations (checkout flows, gated content, etc.).
- One subscriber list per tenant - every card feeds the same list, so subscribers are never split by which card they signed up through.
- A webhook fired on every new subscriber.
Design a signup card
- Newsletter → New card. Name it (e.g. "Blog updates") - the slug is auto-generated.
- Set the headline, subtext and button label. These are what visitors see on your site.
- Style it. Pick colours, corner radius and font to match the site you're embedding on. The right pane shows a live preview as you go.
- Save & publish. Only published cards can be embedded.
Embed on your site
Open the card → Developer → Embed the widget.
- Create a widget key. Add the domain(s) you'll embed on (e.g.
https://example.com). The key is locked to those origins. - Copy the snippet - drop it into any HTML page.
<script src="https://app.softsolz.uk/softsolz.js"
data-public-key="pk_live_…"
data-service-id="newsletter"
data-card-slug="blog-updates"></script>The script injects a sandboxed iframe that renders your themed card and posts the subscription straight to your tenant's list. Auto-resizes with content. No build step required.
Subscriber list
Newsletter → Subscribers shows every subscriber across every card, tagged with which card and source they came in through. From here you can search, filter, and remove subscribers, or export the list as CSV.
Consent and confirmation
The Consent button on the Subscribers page controls how people opt in and what you keep as proof:
- Require email confirmation (double opt-in). New sign-ups get a confirmation email and sit at awaiting confirmation until they click the link. They are not counted as subscribers and receive nothing until they confirm. Recommended for UK and EU marketing lists. This needs your own sending address first - SoftSolz never emails your subscribers from its address, so the switch stays locked until you have set up your own sending address. If you had it on and then removed your sending address, new sign-ups are accepted straight away instead of waiting on a confirmation that could not be sent.
- Consent wording. The exact sentence people agree to. It is stored on every sign-up along with the date and the page they signed up from, and appears in the Consent column and the CSV export.
Every subscriber gets a personal unsubscribe link they can use without signing in, and can re-subscribe from the same link. Rows captured before you turned consent recording on show Not recorded.
Blog sign-ups can flow into this list automatically - see Send blog sign-ups to your newsletter. They arrive with their original consent record and are not asked to confirm twice.
Use the API
Two integration paths:
| Path | Auth | When to use |
|---|---|---|
| Widget - the embedded signup card | pk_… public key (browser) |
Visitors subscribe from your site via the embedded card. |
Server - POST /api/v1/services/newsletter/subscribe |
sk_… secret key (server) |
Your backend adds subscribers directly (checkout flows, gated downloads, imports). |
Full reference: developer.softsolz.uk/reference.
Common changes & risks
- Editing card copy or style - safe any time, updates live on every site embedding it.
- Unpublishing a card - the embedded widget stops rendering on sites using it. Existing subscribers are unaffected.
- Deleting a subscriber - removes them from the tenant-wide list; they won't receive future campaigns sent through your own email tool.