Newsletter sign-up
FreeFlow@rabbinatix/newsletter-sign-up by Rabbinatixupdated Oct 13, 2026
A visitor joins a mailing list; the subscription service adds them once and sends a confirmation email.
Join a mailing list without duplicates:
- Client app sends the email and the list name, and shows the answer.
- Subscription service checks the email, answers 200 for someone already on the list, otherwise adds them as pending and sends a confirmation email.
- Subscriber store answers the lookup and keeps the subscribers. Mailer (optional) sends the confirmation email.
Subscribing twice is not an error: the second time just says they are already on the list.
Previewlanes are roles; you pick your systems when importing
- No matches
Not found200400Other
Start in Client app. step 1 of 16. key stepOn Subscribe to newsletter
Call to another system in Client app. step 2 of 16. key stepCall subscribe
Start in Subscription service. step 3 of 16. key stepOn POST /api/v1/subscriptions
Resource in Subscription service. step 4 of 16. key stepFind subscriber
Answer in Subscriber store. step 5 of 16. key stepsubscribers.find
Return in Subscription service. step 6 of 16. key stepAlready on the list → 200
Resource in Subscription service. step 7 of 16. key stepAdd subscriber
Answer in Subscriber store. step 8 of 16. key stepsubscribers.insert
Resource in Subscription service. step 9 of 16Send confirmation email
Answer in Mailer. step 10 of 16. key stepmail.sendSubscriptionConfirm
Return in Subscription service. step 11 of 16. key stepReturn 201
Return in Subscription service. step 12 of 16. key stepInvalid email → 400
Return in Client app. step 13 of 16. key stepReturn
Return in Client app. step 14 of 16. key stepReturn
Return in Client app. step 15 of 16. key stepReturn
Return in Client app. step 16 of 16. key stepReturn
Client app
Web frontend
Subscription service
Backend service
Subscriber store
Database
Mailer
External API
Up and down arrows: previous or next step. Home, End: first or last. Enter: select. Shift F10: more actions.
APIs
POST{base}/subscriptions· Subscribe to a mailing list
Subscription service provides it · Client app calls it
Request body
email: string list: string
201
status: string
200
status: string
400
error: string
Data operations
subscribers.findqueryon Subscriber store(email: string, list: string)
subscribers.insertinserton Subscriber store(email: string, list: string, status: string)
mail.sendSubscriptionConfirmcallon Mailer(to: string, list: string)
Test cases
New subscriber→ Subscribed, waiting for confirmation
Already subscribed→ Already subscribed
Invalid email→ Invalid email
Empty email→ Invalid email
Confirmation email sent→ Subscribed, waiting for confirmationwith “Send a confirmation email”
Requirements
An email is on a list only once.
Only valid emails can subscribe.
Roles (4)
Client app
Where the visitor types the email · Web frontend or mobile app
Subscription service
Adds subscribers and sends the confirmation · Backend service
Subscriber store
Database with the subscribers · Database
Mailer (optional)
Sends the confirmation email (optional) · External API or backend service
Settings
Send a confirmation emailon
Email fieldemail (renamable)
Versions
