Automated Newsletter Dogfooding

​

1. Architecture Overview

​

2. API Endpoints

​

Subscribing a User

curl -X POST https://api.example.com/api/newsletter/subscribe \
  -H "Content-Type: application/json" \
  -d '{
    "email": "developer@example.com",
    "source": "website_footer"
  }'

​

Fetching Active Subscribers

curl -X GET "https://api.example.com/api/newsletter/subscribers?status=Active&page=1&pageSize=100" \
  -H "X-Newsletter-Secret: qxa_live_YOUR_KEY"

​

3. The Visual Workflow Recipe

​

Step 1: Fetch Active Subscribers Node

• Node Type: http
• Method: GET
• URL: https://api.example.com/api/newsletter/subscribers?status=Active
• Headers: X-Newsletter-Secret: {{variables.NEWSLETTER_SECRET}}

​

Step 2: For-Loop Iterator Node

• Node Type: for
• Collection: {{GetSubscribers.response.subscribers}}
• Item Variable: subscriber
• Index Variable: loopIndex

​

Step 3: Dispatch Issue Node

• Node Type: http
• Method: POST
• URL: https://api.example.com/api/newsletter/send
• Headers:
  • Content-Type: application/json
  • X-Newsletter-Secret: {{variables.NEWSLETTER_SECRET}}
• Payload:

{
  "recipientEmail": "{{subscriber.email}}",
  "unsubscribeToken": "{{subscriber.unsubscribeToken}}",
  "subject": "The Quixa Dispatch: docs.quixa.io is Live, Switch Routers & Dogfooding"
}

​

Step 4: Rate-Limit Throttle

• Node Type: wait
• Duration: 250ms (fixed buffer to stay within SMTP or provider limits).

​

Step 5: Terminal Completion Node

• Node Type: stop
• Scope: terminate-flow
• Exit Status: Completed
• Message: Newsletter campaign execution completed successfully.

​

4. Unsubscription & GDPR Compliance

https://api.example.com/api/newsletter/unsubscribe?token=3f8a1b2c4d5e6f7a8b9c0d1e2f3a4b5c

1. The subscriber’s status is atomically changed from Active to Unsubscribed.
2. The UnsubscribedAt timestamp is recorded.
3. Subsequent workflow dispatch requests for this email address are immediately rejected with HTTP 400 Bad Request.
4. The user is presented with a branded, dark-mode confirmation page with options to return to the homepage or resubscribe.