Bounce Tracking

Workestra tracks the delivery status of every email sent through the workspace Resend key. Bounces, complaints, and delivery confirmations are recorded automatically via webhooks.

How It Works

An email is sent via Resend from any module (CRM, Support, Recruiting)
Resend processes the email and sends delivery events back to Workestra
Events are matched to the original email in the email_logs table
The delivery status is updated in real time

Tracked Events

Event	Status	Description
`email.sent`	Sent	Email accepted by Resend for delivery
`email.delivered`	Delivered	Email successfully delivered to recipient's mail server
`email.bounced`	Bounced	Recipient server rejected the email
`email.complained`	Complained	Recipient marked the email as spam
`email.delivery_delayed`	Delayed	Delivery is being retried by the provider

Bounce Types

When an email bounces, Workestra records the bounce type and reason:

Type	Meaning	Action
Hard bounce	Address doesn't exist or domain is invalid	Remove or correct the email address
Soft bounce	Temporary issue (mailbox full, server down)	Resend will retry automatically
Complaint	Recipient reported as spam	Stop emailing this contact

Repeated hard bounces and spam complaints can damage your domain's sending reputation. Monitor bounce rates and clean your contact lists regularly.

Viewing Delivery Status

Email delivery status is visible in several places:

Contact activity timeline — Each sent email shows its current delivery status
Email logs — Admins can review delivery status across all sent emails
Deal/ticket activity — Emails sent from deals or tickets show delivery status inline

Setting Up Bounce Tracking

Bounce tracking requires a webhook from Resend to Workestra. Your workspace admin needs to configure this once:

Step 1: Get Your Webhook URL

Your Workestra bounce webhook URL is:

https://your-domain.com/api/webhooks/resend

Step 2: Configure in Resend

Go to resend.com/webhooks
Click Add Webhook
Enter your Workestra webhook URL
Select these events:
- email.sent
- email.delivered
- email.bounced
- email.complained
- email.delivery_delayed
Copy the Signing Secret
Save the webhook

Step 3: Add the Signing Secret

Add the Resend webhook signing secret to your environment variables:

RESEND_WEBHOOK_SECRET=whsec_xxxxxxxxxxxxx

The webhook secret is used to verify that incoming events are genuinely from Resend, preventing spoofed delivery events.

Best Practices

Monitor bounce rates — A bounce rate above 5% can trigger delivery issues
Remove hard bounces — Update or remove contacts with invalid email addresses
Handle complaints immediately — Unsubscribe contacts who mark you as spam
Use verified domains — Sending from verified domains improves deliverability
Check domain status — Use the domain verification badge in Workspace Email Settings

Next Steps

Workspace Email Settings — Configure Resend and sender identity
Sending Emails — Compose and send from modules

Bounce Tracking

On this page