> For the complete documentation index, see [llms.txt](https://docs.harmony.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.harmony.io/settings/configuring-email-domains-and-dkim-verification.md).

# Configuring Email Domains and DKIM Verification

By default, Harmony sends email notifications from `notifications@harmony.io`. 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.harmony.io/settings/configuring-email-domains-and-dkim-verification.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.