> ## Documentation Index
> Fetch the complete documentation index at: https://docs.typewise.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Email delivery

> Outbound emails aren't reaching customers

**Alert**: "Can't send emails to customers"

**Impact**: Customer replies from you and your AI Agent fail silently.

## Quick diagnosis

| Symptom                                | Likely cause                       | Fix                                       |
| -------------------------------------- | ---------------------------------- | ----------------------------------------- |
| Domain shows "Pending" or "Failed"     | DNS records missing or wrong       | [Verify DNS records](#verify-dns-records) |
| Domain shows "Success" but emails fail | SPF record missing `amazonses.com` | [Fix SPF record](#fix-spf-record)         |
| Only some emails fail                  | Recipient-side issue               | No action needed                          |

## Verify DNS records

<Steps>
  <Step title="Open Email Settings">
    Go to **Behaviour > Channels > Email > Settings**.
  </Step>

  <Step title="Check status">
    Check your domain's verification status.
  </Step>

  <Step title="Update DNS if needed">
    If not "Success":

    * Copy the DNS records shown
    * Add them to your domain host (GoDaddy, Cloudflare, etc.)
    * Wait 5-60 minutes (can take up to 48 hours)
  </Step>
</Steps>

**Required records:**

| Type           | Purpose                                |
| -------------- | -------------------------------------- |
| DKIM (3 CNAME) | Proves emails are from you             |
| SPF (TXT)      | Authorizes Amazon SES to send          |
| DMARC (TXT)    | Tells receivers how to handle failures |

<Note>
  Use [MXToolbox](https://mxtoolbox.com/) to verify your records are live.
</Note>

## Fix SPF record

**If you have an existing SPF record**, add `include:amazonses.com`:

```
v=spf1 a include:amazonses.com include:_spf.google.com ~all
```

**If you don't have one**, create this TXT record:

```
v=spf1 a include:amazonses.com ~all
```

## Verification failed?

* Check for typos or extra spaces in DNS records
* Confirm you're editing the correct domain
* Remove and re-add the records
* Wait longer. Propagation can take 48 hours.

## Emails landing in spam?

* Verify SPF and DKIM records are correct (use
  [MXToolbox](https://mxtoolbox.com/))
* Avoid "no-reply@" addresses. Use a human-like sender.
* Check if your domain is on any blocklists
* Keep subject lines clear and professional

## Test it

<Steps>
  <Step title="Open Email Settings">
    Go to **Behaviour > Channels > Email > Settings**.
  </Step>

  <Step title="Send test">
    Click **Send test email**.
  </Step>

  <Step title="Confirm delivery">
    Confirm it arrives (check spam folder too).
  </Step>
</Steps>

The alert clears after the next successful send.