Email Commands
Deploy and manage AWS SES email infrastructure with event tracking, analytics, and domain management.
wraps email init
Deploy new email infrastructure to your AWS account. This is the primary command for setting up Wraps email for the first time.
npx @wraps.dev/cli email init [options]-d, --domain <domain>Domain to configure for sending emails (e.g., yourdomain.com)
-r, --region <region>AWS region to deploy infrastructure (default: us-east-1)
--preset <preset>Configuration preset: starter, production, enterprise, or custom
-p, --provider <provider>Hosting provider: vercel, lambda, ecs, or ec2
--previewPreview infrastructure changes without deploying
- Validates your AWS credentials and account access
- Prompts for configuration preferences (if not provided via flags)
- Shows estimated monthly AWS costs based on selected features
- Deploys AWS SES, DynamoDB, Lambda, EventBridge, SQS, and IAM roles
- Sets up OIDC provider for Vercel deployments (if selected)
- Creates configuration metadata for future commands
- Takes 1-2 minutes to complete
Interactive setup (recommended for first time):
npx @wraps.dev/cli email initNon-interactive with all options:
npx @wraps.dev/cli email init --domain yourdomain.com --region us-west-2 --preset production --provider vercelwraps email status
Display detailed status for email infrastructure, including SES domains, verification status, and configuration details.
npx @wraps.dev/cli email status- SES domain verification and DKIM status
- MAIL FROM domain configuration
- Active features and preset
- Deployed AWS resources
- DNS records that need configuration
wraps email domains
Manage domains in AWS SES. Add domains, list all configured domains, retrieve DKIM tokens, verify DNS records, and remove domains from SES.
wraps email domains add
Add a new domain to AWS SES with DKIM signing enabled.
npx @wraps.dev/cli email domains add -d <domain>-d, --domain <domain>(required) Domain name to add
wraps email domains list
List all domains configured in AWS SES with their verification and DKIM status.
npx @wraps.dev/cli email domains listwraps email domains get-dkim
Retrieve DKIM tokens for a domain to configure DNS records.
npx @wraps.dev/cli email domains get-dkim -d <domain>-d, --domain <domain>(required) Domain name to get DKIM tokens for
wraps email domains verify
Check the DNS verification status of a domain, including DKIM, SPF, and DMARC records.
npx @wraps.dev/cli email domains verify -d <domain>- SES domain verification status
- DKIM DNS records (3 CNAME records)
- SPF record (TXT record for sender verification)
- DMARC record (TXT record for email authentication policy)
- MAIL FROM MX records (if custom MAIL FROM configured)
- Provides copy-paste ready DNS record values
wraps email domains remove
Remove a domain from AWS SES. This action cannot be undone.
npx @wraps.dev/cli email domains remove -d <domain>-d, --domain <domain>(required) Domain name to remove-f, --forceSkip confirmation prompt
wraps email connect
Connect to existing AWS SES resources and add Wraps features non-destructively. Never modifies your existing SES setup.
npx @wraps.dev/cli email connect [options]--region <region>AWS region to scan for existing resources
--previewPreview infrastructure changes without deploying
- Scans existing SES domains and configuration sets
- Prompts for which features to add
- Creates new resources with
wraps-prefix - Never modifies or deletes existing resources
- Configures event tracking and analytics
wraps email upgrade
Add additional features to your existing Wraps deployment. Upgrade from Starter to Production, or add individual features incrementally.
npx @wraps.dev/cli email upgrade [options]- Shows currently enabled features
- Prompts for additional features to enable
- Deploys new resources incrementally
- Updates IAM policies with new permissions
- Shows updated cost estimates
- Starter → Production: Adds real-time event tracking and 90-day history
- Production → Enterprise: Adds dedicated IP and 1-year history retention
- Add individual features: Enable specific event types or extend storage
wraps email sync
Synchronize your local configuration with deployed infrastructure. Useful after CLI updates.
npx @wraps.dev/cli email sync [options]- Detects differences between local config and deployed infrastructure
- Applies CLI updates (bug fixes, new features) to resources
- Updates Lambda functions and IAM policies
- Does not change your configuration preset or features
wraps email restore
Restore Wraps deployment from existing metadata. Useful if you've lost local configuration but infrastructure still exists in AWS.
npx @wraps.dev/cli email restore [options]- Scans AWS for existing Wraps resources
- Reconstructs deployment metadata
- Re-imports Pulumi stack state
- Restores local configuration
wraps email destroy
Remove email infrastructure. Use this to remove only the email service while keeping other services intact.
npx @wraps.dev/cli email destroy [options]-f, --forceSkip confirmation prompt (use with caution)
--previewPreview what would be destroyed without making changes
- Email-specific IAM roles and policies
- DynamoDB tables (email history will be lost)
- Lambda functions for event processing
- EventBridge rules and SQS queues
- Route53 DNS records (DKIM, DMARC, MAIL FROM) if confirmed
- Local metadata for email service