Email Providers

The contact form supports three email providers. Set your choice in markdesk.config.ts and add the corresponding environment variable.

Resend

Resend is a modern email API with a generous free tier.

1. Sign up at resend.com and get an API key.
2. Set emailSender: 'resend' in markdesk.config.ts.
3. Add your API key to .env:

RESEND_API_KEY=re_xxxxxxxxxxxxx

4. Install the package:

npm install resend

5. Verify your sending domain in the Resend dashboard. The fromEmail in your config must use a verified domain.

SendGrid

SendGrid is an established email delivery service.

1. Sign up at sendgrid.com and create an API key with "Mail Send" permissions.
2. Set emailSender: 'sendgrid' in markdesk.config.ts.
3. Add your API key to .env:

SENDGRID_API_KEY=SG.xxxxxxxxxxxxx

4. Install the package:

npm install @sendgrid/mail

5. Verify a sender identity in SendGrid. The fromEmail in your config must be a verified sender.

Nodemailer (SMTP)

Use any SMTP server — your own mail server, Gmail, Amazon SES, etc.

1. Set emailSender: 'nodemailer' in markdesk.config.ts.
2. Add your SMTP credentials to .env:

SMTP_HOST=smtp.example.com
SMTP_PORT=587
SMTP_USER=your-username
SMTP_PASS=your-password

3. Install the package:

npm install nodemailer

Testing

After setting up your email provider, test the contact form by submitting a message through your help center. Check that emails are delivered to the supportEmail address in your config.