Email CLI Commands

Email CLI Commands | Wraps

CLI Reference / Email

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.

-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

--preview

Preview 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):

Non-interactive with all options:

wraps email status

Display detailed status for email infrastructure, including SES domains, verification status, and configuration details.

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.

-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.

wraps email domains get-dkim

Retrieve DKIM tokens for a domain to configure DNS records.

-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.

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.

-d, --domain <domain> (required) Domain name to remove
-f, --force Skip confirmation prompt

wraps email inbound

Deploy and manage inbound email receiving infrastructure. Receive emails at your domain, parse them automatically, and process with your application.

wraps email inbound init

Deploy inbound email receiving infrastructure to your AWS account.

-d, --domain <domain> Domain to receive emails at
-r, --region <region> AWS region (must support SES inbound)

S3 bucket for storing incoming emails
SES receipt rule set with active rule
Lambda function to parse and process emails
EventBridge rule for email.received events
IAM roles and policies for cross-service access

wraps email inbound status

Display the status of inbound email infrastructure, including MX records and receipt rules.

wraps email inbound test

Send a test email to verify your inbound configuration is working correctly.

-t, --to <address> Email address to send test to (must be on your inbound domain)

wraps email inbound destroy

Remove inbound email infrastructure. Stored emails in S3 will remain unless you delete the bucket manually.

-f, --force Skip confirmation prompt

wraps email connect

Connect to existing AWS SES resources and add Wraps features non-destructively. Never modifies your existing SES setup.

--region <region>

AWS region to scan for existing resources

--preview

Preview 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.

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 local state with deployed infrastructure. Useful after CLI updates or manual AWS console changes.

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.

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.

-f, --force

Skip confirmation prompt (use with caution)

--preview

Preview 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

wraps email test

Send a test email using the AWS SES mailbox simulator. Verify your email infrastructure is working without affecting your sender reputation.

--to <email>

Recipient email address (defaults to SES simulator address)

--scenario <type>

Simulator scenario: bounce, complaint, or success

--json

Output result as JSON

Sends a test email via the AWS SES mailbox simulator
Shows the delivery result and message ID
Supports different scenarios to test bounce and complaint handling

wraps email check

Run a comprehensive deliverability audit on your domain. Checks all critical email authentication records and provides an overall deliverability score.

--domain <domain>

Domain to audit

--quick

Skip blacklist check for faster results

--json

Output result as JSON

DKIM records and signing configuration
SPF alignment and record validity
DMARC policy strength and configuration
MX record TLS support
Blacklist presence across major providers
Overall deliverability score with recommendations

wraps email templates

Manage email templates as code. Initialize a templates directory, preview with hot-reload, and push compiled templates to SES and the Wraps dashboard.

wraps email templates init

Initialize a templates-as-code directory with an example template, configuration file, and brand file.

wraps email templates preview

Start a local preview server with hot-reload for developing email templates. Defaults to port 3333.

wraps email templates push

Compile and push templates to AWS SES and the Wraps dashboard.

--template <name> Push a specific template by name
--force Overwrite existing templates without confirmation
--dry-run Preview what would be pushed without making changes
--json Output result as JSON

wraps email workflows

Validate and push email workflow definitions to the Wraps Platform.

wraps email workflows validate

Validate workflow definitions against the Wraps workflow schema. Catches errors before pushing to production.

wraps email workflows push

Push workflow definitions to the Wraps Platform.

wraps email config

Apply CLI configuration updates to deployed infrastructure. Syncs local configuration changes with your deployed AWS resources.

Reads local configuration and compares with deployed infrastructure
Applies any pending configuration changes to AWS resources
Updates IAM policies, Lambda functions, and EventBridge rules as needed

Back to CLI Reference CDN Commands