How to Connect Amazon SES to SendSurface Using EventBridge Webhooks
Connect Amazon Simple Email Service (Amazon SES) to SendSurface through Amazon EventBridge API Destinations so campaign reporting and recipient timelines update automatically in real time.
This is an inbound webhook integration for receiving Amazon SES email delivery and engagement event notifications. It is NOT an inbound email receiving or mailbox integration for reading replies.
Overview
SendSurface integrates with Amazon SES through Amazon EventBridge API Destinations. When Amazon SES emits email delivery and engagement events for messages sent through your AWS account, EventBridge pushes those JSON notifications securely over HTTPS to your SendSurface workspace webhook endpoint.
DeliveryBounceOpenClickDeliveryDelayRendering FailureSubscriptionStep 1: Get Your SendSurface Webhook Details
- Log in to your SendSurface account.
- In the Console left sidebar, open Webhooks and make sure the Email Providers → SendSurface (Inbound) tab is active.
- Click Connect Email Provider and select Amazon SES (or open your existing Amazon SES integration and click Setup Guide).
- Copy these two workspace-specific values:
- Webhook Endpoint URL
- Webhook Verification Secret / Token
https://<your-sendsurface-domain>/api/webhooks/incoming/amazon-ses/{workspace_id}Step 2: Create an Amazon EventBridge Connection
- Open the AWS Management Console and navigate to Amazon EventBridge in the same AWS region as your Amazon SES identity.
- In the left menu under Integration, open API destinations, select the Connections tab, and click Create connection.
- Enter a Connection name such as
sendsurface-ses. - For Destination type, choose Other.
- For Authorization type, select API key.
- Set the API key name to
x-api-keyand paste your SendSurface Webhook Verification Secret / Token into the Value field. - Click Create to save the connection.
sendsurface-sesx-api-keyStep 3: Create an Amazon EventBridge API Destination
- Still under Amazon EventBridge → API destinations, switch to the API destinations tab and click Create API destination.
- Enter a name such as
sendsurface-webhook. - Paste the Webhook Endpoint URL you copied from SendSurface in Step 1 into API destination endpoint.
- Set HTTP method to
POST. - Under Connection, select Use an existing connection and pick
sendsurface-ses. - Set an invocation rate limit per second that comfortably covers your peak campaign volume (for example
50–300requests/sec), then click Create.
sendsurface-webhookStep 4: Create an Amazon SES Configuration Set
- Open Amazon SES in the AWS Management Console (same region as your EventBridge resources).
- In the left sidebar under Configuration, click Configuration sets → Create set.
- Name your configuration set (for example
sendsurface-ses-events) and click Create set.
sendsurface-ses-eventsStep 5: Add Amazon EventBridge as an Event Destination
- Open your newly created Configuration Set (
sendsurface-ses-events) and go to the Event destinations tab. - Click Add destination.
- Select the event types you want SendSurface to track:
- Deliveries (
Delivery) - Hard bounces & Soft bounces (
Bounce) - Opens (
Open) - Clicks (
Click) - Delivery delays (
DeliveryDelay) - Rendering failures (
Rendering Failure) - Subscriptions (
Subscription)
- Deliveries (
- Click Next, select Amazon EventBridge as the destination type, enter a destination name, and select the Default EventBridge event bus (
default). - Review and click Add destination.
Step 6: Create an Amazon EventBridge Rule to Forward SES Events
- Return to Amazon EventBridge → Rules and ensure the
defaultevent bus is selected. - Click Create rule, name it (e.g.,
forward-ses-to-sendsurface), and choose Rule with an event pattern. - Under Event source, select AWS events or EventBridge partner events, then under Creation method choose Custom pattern (JSON editor) and paste the pattern below.
- In Select target(s), choose EventBridge API destination, select
sendsurface-webhook, allow AWS to create a new IAM execution role for invoking the destination, and create the rule.
{
"source": ["aws.ses"]
}Step 7: Attach the Configuration Set to Your Amazon SES Sending
Amazon SES only publishes events to EventBridge when outgoing messages reference your Configuration Set. Choose either method below:
In Amazon SES → Verified identities, open your sending domain or email address, open the Configuration set tab, click Edit, assign sendsurface-ses-events as the default configuration set, and save. Every SMTP campaign sent via SendSurface will emit events automatically.
When sending custom API or SMTP messages outside an identity default, include the X-SES-CONFIGURATION-SET header:
Step 8: Test and Verify the Integration
- In SendSurface Webhooks → Email Providers → SendSurface, click the Test button on your Amazon SES integration to confirm the webhook adapter records a simulated
DELIVEREDevent. - Send a test campaign or test email from SendSurface through your Amazon SES SMTP connection to a real mailbox you control.
- In AWS Console → Amazon EventBridge → Rules, inspect your rule's Monitoring metrics to confirm Invocations increase with zero FailedInvocations.
- In SendSurface Webhooks and Reports, verify that confirmed delivery and bounce/open/click metrics update cleanly.
Security Best Practices & Notes
- SendSurface compares the
x-api-keyheader value against your workspace verification secret using constant-time validation and returns401 Unauthorizedif missing or mismatched. - Never commit your Webhook Verification Secret / Token to source control or share it in public documentation.
- Always configure your EventBridge API Destination with an
https://SendSurface URL so payloads and secrets remain encrypted in transit. - If a token is ever rotated in SendSurface, update the matching secret value in your EventBridge Connection immediately so AWS does not trigger 401 delivery failures.