mcpField
D
double-opt-in-email

double-opt-in-email

github.com/mukul975Marketing & growth32339 installsUpdated 32w ago
Repository

About double-opt-in-email

A practical skill for designing double opt-in email subscription flows. It is intended for teams handling marketing consent and focuses on verification, suppression lists, and compliance across several jurisdictions.

Key features

  1. 01Two-step email consent flow
  2. 02Email format validation
  3. 03Suppression-list checks
  4. 04Token expiry and retry handling
  5. 05Consent rules across jurisdictions

Use cases

  1. 01Building a newsletter sign-up flow
  2. 02Preventing confirmations to suppressed addresses
  3. 03Handling expired or reused confirmation links

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/mukul975/privacy-data-protection-skills --skill double-opt-in-email

After installing, type/double-opt-in-emailin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

assets/
template.md
references/
standards.md
workflows.md
scripts/
process.py

Details

From the project README

Implementing Double Opt-In Email

Overview

Double opt-in (DOI) is the gold standard for email marketing consent. It requires two steps: (1) the user submits their email address and indicates interest, and (2) the user clicks a confirmation link in a verification email. This creates a verifiable consent record that satisfies GDPR Article 7(1) (demonstrability), ePrivacy Directive Article 13 (prior consent for electronic marketing), and German Federal Court of Justice (BGH) rulings that have established DOI as the expected standard in Germany.

Double Opt-In Workflow

START: User enters email on CloudVault SaaS Inc. sign-up or newsletter form
  │
  ├─► Step 1: Initial Opt-In Request
  │     ├─ User enters email address
  │     ├─ User ticks unticked checkbox: "Send me product updates and news"
  │     ├─ Validate email format (RFC 5322)
  │     ├─ Check suppression list — if email is suppressed, do NOT send confirmation
  │     └─ Display: "Check your email to confirm your subscription."
  │
  ├─► Step 2: Generate Confirmation Token
  │     ├─ Create cryptographically random token (256-bit, URL-safe base64)
  │     ├─ Associate token with: email address, purpose, timestamp, IP, user agent
  │     ├─ Set expiration: 48 hours from generation
  │     └─ Store pending subscription record (status: "pending_confirmation")
  │
  ├─► Step 3: Send Confirmation Email
  │     ├─ From: [email protected]
  │     ├─ Subject: "Confirm your CloudVault newsletter subscription"
  │     ├─ Body:
  │     │   ├─ "You requested to receive product updates from CloudVault SaaS Inc."
  │     │   ├─ "Click below to confirm:"
  │     │   ├─ [Confirm Subscription] button → confirmation URL with token
  │     │   ├─ "If you didn't request this, you can ignore this email."
  │     │   ├─ "This link expires in 48 hours."
  │     │   └─ Controller details: CloudVault SaaS Inc., 42 Innovation Drive, Dublin
  │     ├─ Headers:
  │     │   ├─ List-Unsubscribe: <mailto:[email protected]>
  │     │   └─ List-Unsubscribe-Post: List-Unsubscribe=One-Click
  │     └─ Note: This confirmation email is NOT marketing — it is transactional
  │
  ├─► Step 4: User Clicks Confirmation Link
  │     ├─ Validate token: exists, not expired, not already used
  │     ├─ If valid:
  │     │   ├─ Update subscription status: "confirmed"
  │     │   ├─ Record consent with full audit trail:
  │     │   │   ├─ Initial request: timestamp, IP, user agent
  │     │   │   ├─ Confirmation: timestamp, IP, user agent
  │     │   │   └─ Consent text version hash
  │     │   ├─ Add email to active marketing list
  │     │   └─ Display: "Subscription confirmed! You'll receive updates from CloudVault."
  │     │
  │     ├─ If expired:
  │     │   ├─ Display: "This link has expired. Please subscribe again."
  │     │   └─ Delete pending record
  │     │
  │     └─ If already used:
  │           └─ Display: "You're already subscribed."
  │
  └─► Step 5: Ongoing Management
        ├─ Every marketing email includes one-click unsubscribe (RFC 8058)
        ├─ Unsubscribe adds to suppression list (permanent)
        ├─ Consent records retained for demonstration per Art. 7(1)
        └─ Re-consent requested after 24 months of inactivity

Token Expiration and Retry Handling

ScenarioActionReasoning
Token expires (48 hours)Delete pending record, do not send remindersAvoid spam risk; user can re-subscribe
User requests twiceDo not send second confirmation if one is pendingPrevent email flooding
Email bouncesMark pending record as "bounced", do not retryInvalid email address
Token used twiceShow "already subscribed" pagePrevent duplicate records

Suppression List Management

The suppression list is critical for compliance with CAN-SPAM Act Section 7704(a)(3)(A) (10-day unsubscribe processing) and GDPR Article 17(3)(c) (retention for legal obligation compliance):

  1. When someone unsubscribes: Add their email to the suppression list immediately
  2. Suppression list is permanent: Never remove an email from the suppression list automatically
  3. Check before sending: Always check the suppression list before sending any marketing email AND before sending a DOI confirmation email
  4. If a suppressed email re-subscribes: Allow re-subscription but require fresh DOI confirmation; remove from suppression list only after confirmation click

Multi-Jurisdiction Compliance

RequirementGDPR + ePrivacyCAN-SPAM (US)CASL (Canada)
Consent typePrior opt-in (DOI recommended)Opt-out (but DOI is best practice)Express consent (implied consent limited)
UnsubscribeArt. 7(3) — as easy as giving10 business days to process10 business days to process
Sender identificationArt. 13(1)(a)Physical postal address requiredContact information required
Record-keepingArt. 7(1) — demonstrate consentMaintain opt-out requests 3 yearsMaintain consent records
PenaltiesUp to EUR 20M or 4% global turnoverUp to $51,744 per emailUp to CAD 10M per violation

Key Regulatory References

  • ePrivacy Directive Article 13 — Unsolicited communications
  • GDPR Article 7(1) — Demonstrating consent
  • GDPR Article 7(3) — Withdrawal of consent
  • CAN-SPAM Act (15 U.S.C. 7701-7713) — US commercial email requirements
  • CASL (S.C. 2010, c. 23) — Canadian Anti-Spam Legislation
  • RFC 8058 — Signaling One-Click Functionality for List Email Headers
  • German BGH VI ZR 269/12 (2004) — Double opt-in as standard for email marketing consent
  • CNIL Deliberation on Commercial Prospecting (2022) — Email consent requirements

Comments

Markdown supported