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.
Subscribing is immediate - there is no confirmation email step. Make sure your card copy is clear about what people are signing up for.
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.
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.