Configuring Email Domains and DKIM Verification

By default, Harmony sends email notifications from [e-mail]. You can replace this with your own custom email domain so that your end users receive notifications from an address they recognize and trust.

This guide explains how to add a custom email domain, complete DKIM verification, and manage your configured domains.

How it works

When you add a custom domain, Harmony generates a set of DKIM DNS records that you must add to your domain provider. Once those records propagate, you run a verification check inside Harmony. After a domain is verified, Harmony uses it as the sending address for all outbound email notifications.

Adding a custom email domain

1. Go to Settings and open the Email Domains section.
2. Click Add Domain.
3. Enter your domain name (for example, support.yourcompany.com) and confirm.
4. Harmony generates the DKIM DNS records required for your domain. Copy these records.
5. Log in to your domain provider and add the DKIM records to your domain's DNS configuration.
6. Return to Harmony and click Verify to run the verification check.

During verification, Harmony checks each DNS record individually and displays a per-record status in real time so you can see exactly which records have propagated and which are still pending.

Understanding domain verification status

Each domain in your domains table shows one of the following statuses:

Status	Description
Verified	All DKIM records were detected successfully. Harmony can send notifications from this domain.
Unverified	One or more DKIM records could not be detected. DNS changes may still be propagating.
Pending	Verification has not been run yet for this domain.

Retrying DKIM verification

DNS changes can take time to propagate, so verification may not succeed immediately after you add the records to your provider. If verification fails, you do not need to contact support - you can retry directly from the domains table.

To retry verification:

1. Locate the domain in the Email Domains table.
2. Click the Retry Verification option next to the domain.
3. Harmony re-checks all DNS records and updates the per-record status in real time.

Repeat this step as needed until your DNS changes have fully propagated and all records show a verified status.

Managing configured domains

The Email Domains table gives you a central view of every domain you have configured. From this table you can:

• See the current verification status of each domain at a glance.
• Retry verification for any domain that is not yet verified.
• Add additional domains if you need to support multiple sending addresses.

Tips for successful verification

• DNS propagation can take anywhere from a few minutes to 48 hours depending on your provider and your TTL settings.
• Double-check that each DKIM record was saved exactly as shown in Harmony - extra spaces or missing characters are a common cause of failed checks.
• If your provider has a DNS cache, wait for it to clear before retrying verification.
• Some providers require DKIM records to be entered in a specific format (for example, splitting long TXT record values). Consult your provider's documentation if a record fails repeatedly.