EventBridge Events

How It Works

When you send an email through Wraps, SES publishes event notifications to the default EventBridge bus in your AWS account. Wraps creates a rule on that bus to capture events into its processing pipeline — but because it's your bus, you can add your own rules alongside Wraps' rule with zero configuration.

# Email Event Flow## Your App ─→ SES ─→ Configuration Set ─→ EventBridge (default bus)#                                              │#                                    ┌─────────┴─────────┐#                                    │                    │#                              Wraps Rule           Your Rules#                                    │                    │#                                   SQS              [targets]#                                    │#                                 Lambda#                                    │#                                DynamoDB

What Wraps Handles Automatically

Wraps' built-in pipeline captures all configured events and processes them into DynamoDB. You get this for free — custom rules are for anything extra you want to build.

Event Types Reference

SES uses three different naming conventions depending on where you look. This mapping table is the key to writing EventBridge rules correctly.

Delivery Events

Engagement Events

System Events

Inbound Events

Bounce & Complaint Reference

Bounces and complaints are the most important events to handle correctly. AWS monitors your bounce and complaint rates and will suspend your account if they exceed thresholds.

Creating Custom Rules

The default EventBridge bus evaluates all rules independently. Your rules run alongside Wraps' rule with no interference. Create rules in the AWS Console, CLI, CDK, or Terraform using these event patterns.

{  "source": ["aws.ses"],  "detail-type": [    "Email Sent",    "Email Delivered",    "Email Bounced",    "Email Complaint Received",    "Email Opened",    "Email Clicked",    "Email Rejected",    "Email Rendering Failed",    "Email Delivery Delayed",    "Email Subscribed"  ]}

{  "source": ["aws.ses"],  "detail-type": [    "Email Bounced",    "Email Complaint Received"  ]}

{  "source": ["aws.ses"],  "detail-type": ["Email Bounced"],  "detail": {    "bounce": {      "bounceType": ["Permanent"]    }  }}

{  "source": ["wraps.inbound"],  "detail-type": ["email.received"]}

Common Use Cases

Practical examples of what you can build with custom EventBridge rules.

Quotas & Limits

Key EventBridge limits to keep in mind when creating custom rules.

Next Steps