# Double Opt In Email

> Implementation guide for ePrivacy Directive compliant double opt-in email consent. Covers confirmation email workflow design, token expiration handling, record-keeping requirements, suppression list management, and integration with CAN-SPAM Act and CASL requirements for multi-jurisdiction compliance.

- Skill: `mukul975-2/double-opt-in-email` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx skillmds add mukul975-2/double-opt-in-email`
- Raw SKILL.md: https://api.skillmd.com/api/skills/mukul975-2/double-opt-in-email/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- License: Apache-2.0
- Author: mukul975 (https://skillmd.com/u/mukul975-2)
- Updated: 2026-08-19
- Page: https://skillmd.com/skills/mukul975-2/double-opt-in-email

---


# 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: noreply@cloudvault-saas.eu
  │     ├─ 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:unsubscribe@cloudvault-saas.eu>
  │     │   └─ 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

| Scenario | Action | Reasoning |
|----------|--------|-----------|
| Token expires (48 hours) | Delete pending record, do not send reminders | Avoid spam risk; user can re-subscribe |
| User requests twice | Do not send second confirmation if one is pending | Prevent email flooding |
| Email bounces | Mark pending record as "bounced", do not retry | Invalid email address |
| Token used twice | Show "already subscribed" page | Prevent 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

| Requirement | GDPR + ePrivacy | CAN-SPAM (US) | CASL (Canada) |
|------------|----------------|---------------|---------------|
| Consent type | Prior opt-in (DOI recommended) | Opt-out (but DOI is best practice) | Express consent (implied consent limited) |
| Unsubscribe | Art. 7(3) — as easy as giving | 10 business days to process | 10 business days to process |
| Sender identification | Art. 13(1)(a) | Physical postal address required | Contact information required |
| Record-keeping | Art. 7(1) — demonstrate consent | Maintain opt-out requests 3 years | Maintain consent records |
| Penalties | Up to EUR 20M or 4% global turnover | Up to $51,744 per email | Up 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