Workspace Email Settings
Configure Resend API, sender identity, domain verification, and rate limits for workspace-level email.
Workspace Email Settings
Configure how your workspace sends transactional and outbound emails. This applies to all emails sent via the Workspace Email option (not connected Gmail/Outlook accounts).
Accessing Email Settings
Go to Settings → Administration → Email tab. This requires Admin or Owner role.
Resend API Key
Workestra uses Resend as its email delivery provider. You can use the platform's shared key or configure your own for better deliverability and custom sender domains.
Using the Platform Key (Default)
If no workspace key is configured, emails are sent using the platform's shared Resend key. Emails will appear from the platform's sender address.
Using Your Own Key
- Create a Resend account at resend.com
- Go to API Keys in the Resend dashboard
- Create a new API key with Sending access
- Paste it into the Resend API Key field in Workestra
- Click Save Email Settings
When you enter a new API key, the existing key is replaced. Leave the field blank to keep the current key.
Sender Identity
Configure how your workspace appears in the From field of outbound emails:
| Field | Description | Example |
|---|---|---|
| From Name | Display name shown to recipients | Acme Corp |
| From Email | Email address used for sending | hello@acme.com |
A preview of the combined sender identity is shown below the fields:
Acme Corp <hello@acme.com>The domain in your From Email (e.g., acme.com) must be verified in your Resend account. Unverified domains will cause delivery failures.
Domain Verification
After saving your sender identity, Workestra checks the domain verification status with Resend:
| Status | Meaning |
|---|---|
| Verified | Domain DNS records are configured correctly. Emails will be delivered. |
| Pending | DNS records have been added but not yet propagated. Allow up to 48 hours. |
| Not Found | Domain is not registered in your Resend account. Add it at resend.com/domains. |
The verification status badge appears below the sender identity fields. Click Manage domains to open the Resend domain configuration page.
Enable/Disable Outbound Email
The Enable outbound email toggle controls whether workspace-level email sending is active:
- Enabled — Emails sent via "Workspace Email" use your Resend key and sender identity
- Disabled — Falls back to the platform's shared key and sender address
This is useful for temporarily pausing workspace email sending without removing your configuration.
Sending a Test Email
Verify your configuration by sending a test email:
- Configure your API key and sender identity
- Click Save Email Settings
- Click Send Test Email
- Check your inbox for the test message
The test email is sent to your Workestra account email and includes details about the configuration being used (provider, sender identity, workspace name).
Email Rate Limits
To protect your sending reputation and prevent abuse, Workestra enforces per-workspace rate limits:
| Limit | Default | Description |
|---|---|---|
| Hourly | 200 emails | Maximum emails per rolling hour |
| Daily | 2,000 emails | Maximum emails per rolling day |
When a limit is reached, email sending is temporarily blocked until the window resets. The user sees a clear error message indicating which limit was hit.
Rate limits apply to emails sent via the workspace Resend key. Emails sent through connected Gmail/Outlook accounts are subject to those providers' own limits.
How Rate Limiting Works
- Counters are tracked per workspace using atomic database operations
- The hourly counter resets at the start of each hour
- The daily counter resets at midnight UTC
- Both limits must have remaining capacity for an email to be sent
Next Steps
- Bounce Tracking — Monitor delivery status and bounces
- Sending Emails — Compose and send from modules
- Scheduled Emails — Send emails at a future time