How Email Delivery Works

Demeterrr uses Resend as its email service provider. Resend handles:

• Reliable email delivery with high inbox placement rates
• Professional HTML email rendering
• Delivery status tracking
• Bounce and complaint handling
• Email tagging for analytics

You don't need to configure anything to use Resend for basic sending. Your organization's administrator handles any necessary setup in the background.

When you send a survey invitation via email, Demeterrr automatically generates a professionally formatted HTML email.

Every survey invitation email includes:

Subject Line

• Format: [Your Company Name] wants your feedback
• Personalized with your organization's name
• Clear and action-oriented

Email Body

• Personalized greeting with the contact's first name (if available)
• Your company name prominently displayed
• The survey name you're sending
• A branded call-to-action button linking to the survey
• Your company logo (if configured in organization settings)
• Brand colors matching your organization's theme
• Footer with unsubscribe link for compliance

The email renderer uses data from several sources:

From Contact Record

• First name for greeting: "Hi Sarah!" or just "Hi!" if no name available

From Organization Settings

• Company name
• Logo URL (displayed at top of email)
• Brand color (used for buttons and accents)

From Survey

• Survey name: "Customer Satisfaction Survey" or "Feedback Survey" if none specified

From Sending

• Unique survey link (tracked to this specific sending)
• Unsubscribe link (required for compliance)

To update your organization's logo and brand color, visit Settings > Organization.

By default, emails are sent from:

• Name: Your organization name
• Email: The address configured in RESEND_FROM_EMAIL environment variable

During onboarding, this defaults to demeterrr <onboarding@resend.dev>, which is Resend's testing sender.

For production use, your administrator should:

1. Verify a custom domain in Resend (e.g., feedback@yourbusiness.com)
2. Update the RESEND_FROM_EMAIL environment variable
3. Configure SPF and DKIM records for maximum deliverability

Using a verified custom domain dramatically improves:

• Inbox placement rates (fewer spam folder deliveries)
• Trust and brand recognition
• Email open rates
• Compliance with email authentication standards

Contact support if you need help setting up a custom sender domain.

Every email sent through Demeterrr includes metadata tags for tracking and analytics.

Each survey invitation email includes:

Type Tag

• Name: type
• Value: survey_invite
• Purpose: Identifies this as a survey invitation (vs. reminder, review request, etc.)

Sending ID Tag

• Name: sending_id
• Value: The unique ID of the sending record
• Purpose: Links email events back to your sending for tracking

These tags flow into Resend's dashboard and webhooks, allowing you to:

• Track delivery, open, and click rates
• Correlate email events with survey responses
• Debug delivery issues
• Analyze campaign performance

While Demeterrr doesn't currently surface Resend analytics in the dashboard, your administrator can:

• Log into the Resend dashboard to view detailed metrics
• Set up webhooks to capture delivery events
• Export email activity data for analysis

Future versions of Demeterrr will integrate these metrics directly into the Sendings and Reports pages.

For bulk sending operations, Demeterrr uses Resend's batch API to improve performance.

When you send to multiple contacts at once:

• Contacts are grouped into batches of up to 100 emails
• Each batch is submitted to Resend in a single API call
• All emails in a batch are processed in parallel
• Each email still has its unique tracking and survey URL

This approach:

• Reduces API overhead
• Speeds up large sends
• Maintains individual email personalization
• Keeps per-contact tracking intact

Batching happens automatically in the background. You don't need to do anything special to enable it.

Every email includes a mandatory unsubscribe link in the footer for compliance with anti-spam laws.

When a contact clicks the unsubscribe link:

1. They're taken to a simple unsubscribe confirmation page
2. They can click "Unsubscribe" to opt out
3. Their contact record is marked as unsubscribed: true
4. Future sending attempts to this contact are automatically cancelled
5. They see a confirmation message

Unsubscribed contacts:

• Will not receive any future survey invitations
• Will not receive review requests
• Can be manually re-subscribed by editing their contact record

See Unsubscribe Management for details on managing opt-outs.

The unsubscribe link ensures compliance with:

• CAN-SPAM Act (United States)
• Canadian anti-spam regulations
• GDPR (European Union)
• Other international email marketing regulations

Never remove or hide the unsubscribe link. It's required by law and builds trust with your customers.

After sending, emails can have several statuses in Resend's system.

Delivered

• Email successfully reached the recipient's mail server
• Most common successful status

Bounced

• Email was rejected by the recipient's server
• Hard bounces: Invalid email address, domain doesn't exist
• Soft bounces: Mailbox full, temporary server issue

Complained

• Recipient marked the email as spam
• Future emails to this address should be avoided
• Consider marking the contact as unsubscribed

Opened

• Recipient opened the email (tracked via invisible pixel)
• Not 100% accurate due to email client privacy features
• Useful for general engagement metrics

Clicked

• Recipient clicked a link in the email (survey URL or unsubscribe)
• Strong signal of engagement

Currently, Demeterrr doesn't automatically update sending records based on Resend webhooks, but this is planned for future versions.

Follow these best practices to ensure your emails reach the inbox.

✅ Verify your domain in Resend with SPF and DKIM records ✅ Use a professional sender address (not a free email provider) ✅ Avoid spam trigger words in your survey names and company name ✅ Maintain a clean contact list by honoring unsubscribes

✅ Don't send too frequently to the same contacts ✅ Remove bounced emails from your contact list ✅ Monitor complaint rates and unsubscribe promptly ✅ Send only to opted-in contacts who expect to hear from you

✅ Use clear, honest subject lines that match the email content ✅ Keep emails concise and focused on the survey request ✅ Include your logo and brand colors for recognition ✅ Always include an unsubscribe link (automatically added)

Emails going to spam

• Verify your custom domain in Resend
• Check SPF and DKIM DNS records
• Avoid spam trigger words
• Ensure contacts opted in to communications

Emails not being received

• Verify the contact's email address is correct
• Check Resend dashboard for bounce or complaint events
• Confirm your Resend account is in good standing
• Look for typos in the email address

Personalization not working

• Ensure contact has firstName in their record
• Check organization settings for logo and brand color
• Verify survey name is set if sending a specific survey

Unsubscribe link not working

• Confirm your application is accessible at the configured URL
• Check that the unsubscribe page is deployed
• Verify database connectivity for updating contact status

Now that you understand email delivery, explore:

• How to send surveys to individual contacts
• Understanding SMS delivery and quotas
• Bulk sending to multiple contacts
• Tracking delivery and response status
• Managing unsubscribes and preferences