Messaging Integrations
Control how your workspace sends notifications to employees over email (and, soon, WhatsApp). The Messaging page lets you toggle email delivery, pick a provider, and plug in your own credentials if you don’t want to use RadixHR’s built-in sender.
What you can do here:
- Enable or disable email notifications for your workspace
- Choose between RadixHR Email (default platform sender) or your own Custom SMTP server
- Add a custom Resend API key to override the default sender
- Configure WhatsApp once the channel is available (currently coming soon)
The page subtitle reads “Configure email and WhatsApp messaging for notifications”, but WhatsApp configuration is not yet live. Today, only the Email section is editable. WhatsApp is documented separately under the Notifications page where it’s marked Soon.
Page Header
| Element | Description |
|---|---|
| Breadcrumb | Settings > Integrations > Messaging |
| Title | ”Messaging Integrations” |
| Subtitle | ”Configure email and WhatsApp messaging for notifications” |
The Email section is the heart of this page — every notification, payslip email, password reset, etc. uses what’s configured here.
System-level Status
A small badge at the top-right of the Email section tells you whether email is enabled at the system level:
| Badge | What it means |
|---|---|
| (none) | Email is enabled at the system level — you can configure it for your workspace |
email is disabled at system level (amber) | A platform administrator has disabled email entirely. You’ll see this status in the badge and a yellow “Disabled by administrator” notice will appear in the section. The workspace-level toggle is read-only until the admin re-enables it. |
Enable Email Toggle
| Setting | Description | Default |
|---|---|---|
| Enable Email | When ON, your workspace can send emails. When OFF, no email is delivered for this workspace. | ON (subject to system-level status) |
If the page shows Disabled by administrator for either channel, the workspace switch is locked. Contact your platform admin if you need email turned on.
Email Provider
Choose where your outgoing email is sent from:
| Option | What it does |
|---|---|
| RadixHR Email (Default) | Uses RadixHR’s built-in transactional email service. No configuration needed; your emails go out from the default platform sender. |
| Custom SMTP | Sends through your own mail server. Requires your SMTP host, port, username, password, and From address. |
Email Credentials
The credentials panel changes depending on the provider you picked.
RadixHR Email Credentials
When RadixHR Email is selected, the panel shows an explainer card:
“RadixHR Email is enabled by default and uses the platform sender. Add a Resend API key only if you want to override with your own Resend account.”
| Field | Description | Required |
|---|---|---|
| Custom Resend API Key (Optional) | Add your own Resend API key here to send emails from your own Resend account instead of the RadixHR default sender. Use the Add API Key button on the right to configure it. Status reads Not configured until you add one. | No |
A second informational card below confirms current behaviour: “RadixHR Email is managed by default. If you add a custom Resend API key, it will override the default sender for this workspace.”
Custom SMTP Credentials
When Custom SMTP is selected, the form below the provider picker exposes the standard SMTP fields:
| Field | Description | Required |
|---|---|---|
| SMTP Host | Your mail server hostname (e.g., smtp.gmail.com, smtp.office365.com) | Yes |
| SMTP Port | The mail server port. Common values: 587 (STARTTLS), 465 (SSL/TLS), 25 (unencrypted). Default: 587. | Yes |
| SMTP Username | The username used to authenticate against your mail server | Yes |
| SMTP Password | The matching password | Yes |
| From Name | The “from” display name in outgoing emails (e.g., “HR Department”) | No |
| From Email | The “from” address (e.g., hr@company.com) | Yes |
| Reply-To | The address where replies should land, if different from From Email | No |
| Use SSL/TLS | ON for implicit TLS (usually port 465). OFF for STARTTLS (usually port 587). | No |
For Gmail, generate an App Password — Google blocks logging in with your normal password from third-party services. For Microsoft 365, use the regular mailbox credentials with port 587.
WhatsApp messaging is not yet generally available in RadixHR. You’ll see WhatsApp listed as Soon in the channel headers on the Notifications page, but no editable configuration appears on this Messaging page today.
When WhatsApp launches, you’ll be able to:
- Enable WhatsApp notifications for your workspace
- Plug in a Meta Business Platform access token
- Set a webhook verify token and subscribe to
messageswebhook events
If you need WhatsApp notifications today, contact RadixHR support — early-access slots may be available depending on your plan.
Tips and Best Practices
Start with the default sender. RadixHR Email works out of the box and is the simplest option. Only switch to Custom SMTP or a custom Resend key if you specifically need email to come from your own domain.
Match the port to the encryption mode. Port 587 typically pairs with Use SSL/TLS OFF (STARTTLS upgrade). Port 465 typically pairs with Use SSL/TLS ON (implicit TLS). Getting this combination wrong is the most common SMTP setup mistake.
Changing the email provider doesn’t migrate previously-sent emails — historical records and bounce logs stay with whichever provider sent them. Test thoroughly after switching.