> For the complete documentation index, see [llms.txt](https://docs.hubble.vote/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hubble.vote/product-guides/mailbox-configuration.md).

# Mailbox Configuration

{% hint style="info" %}
This feature requires the Communication Hub. You must be a Manager or higher in the Universe.
{% endhint %}

A mailbox is an email address that Hubble sends from and receives at, for example `info@yourcampaign.com`.

Hubble sends email through Amazon Simple Email Service (SES). Before a mailbox can send, you must add some DNS records for its domain. These records prove that you own the domain. They also help your emails go to the inbox, not to spam.

The work takes approximately 10 minutes.

## Before you start

You must have access to the DNS settings of your domain.

{% hint style="warning" %}
Hubble also receives the mail for the domain of the mailbox. If your domain already receives mail at a different provider (for example, Google Workspace or Microsoft 365), do not use that domain for the mailbox. Use a subdomain, for example `info@comms.yourcampaign.com`. If you add the Hubble receiving record to a domain that already receives mail, some of that mail can go to Hubble.
{% endhint %}

## Step 1: Create the mailbox

1. In the Admin Hub, open **Mailboxes**.
2. Select **New**.
3. Enter the **Display name** and the **Address**.
4. Optional: In **Notify this address about new mail**, enter an email address. Hubble sends a message to this address when mail arrives in the mailbox.
5. Select **Create**.

## Step 2: Wait for approval

Hubble Support must approve each mailbox. After approval, Hubble sets up the domain with SES. This takes approximately one minute.

Then the mailbox page shows the **Domain setup** card. This card lists the DNS records that you must add.

## Step 3: Add the DNS records

Add each record from the **Domain setup** card at your DNS provider. Copy each value exactly.

The records look like this example for `yourcampaign.com`:

| Purpose                      | Type    | Host                                  | Value                                      |
| ---------------------------- | ------- | ------------------------------------- | ------------------------------------------ |
| DKIM signing (three records) | `CNAME` | `<token>._domainkey.yourcampaign.com` | `<token>.dkim.amazonses.com`               |
| Bounce handling (MAIL FROM)  | `MX`    | `comms.yourcampaign.com`              | `10 feedback-smtp.us-east-2.amazonses.com` |
| Bounce handling (MAIL FROM)  | `TXT`   | `comms.yourcampaign.com`              | `v=spf1 include:amazonses.com ~all`        |
| Receiving                    | `MX`    | `yourcampaign.com`                    | `10 inbound-smtp.us-east-2.amazonaws.com`  |
| Recommended                  | `TXT`   | `_dmarc.yourcampaign.com`             | `v=DMARC1; p=none;`                        |

{% hint style="info" %}
The table above is only an example. Your tokens and hosts are different. Always use the values from the mailbox page.
{% endhint %}

Some DNS providers add your domain to the host automatically. For these providers, enter only the first part of the host. For example, enter `comms`, not `comms.yourcampaign.com`.

Some DNS providers have a different field for the MX priority. For these providers, enter `10` in the priority field. Enter only the server name in the value field.

The DMARC record is optional. If your domain already has a DMARC record, keep it. Do not add a second one.

## Step 4: Wait for verification

Hubble and SES look for your records for 72 hours. On the mailbox page, each record shows **found** when Hubble sees it. To look again immediately, select **Check DNS now**.

The mailbox can send after Hubble finds all of the DKIM, MAIL FROM and receiving records.

If Hubble does not find the records in 72 hours, the setup stops. Correct the records, then contact [Hubble Support](mailto:help@hubble.vote) to try again.