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

# Email

> Send DevHelm incident alerts to email addresses

The simplest alert channel — send incident notifications directly to email addresses. Available on all plans, including Free.

**Plan requirement:** Free (all plans)

## Setup

<CodeGroup>
  ```bash CLI theme={null}
  devhelm alert-channels create \
    --name "Team Email" \
    --type email \
    --config '{"channelType":"email","recipients":["oncall@example.com","team@example.com"]}'
  ```

  ```yaml devhelm.yml theme={null}
  alertChannels:
    - name: Team Email
      config:
        channelType: email
        recipients:
          - oncall@example.com
          - team@example.com
  ```

  ```bash API theme={null}
  curl -X POST https://api.devhelm.io/api/v1/alert-channels \
    -H "Authorization: Bearer $DEVHELM_API_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "name": "Team Email",
      "config": {
        "channelType": "email",
        "recipients": ["oncall@example.com", "team@example.com"]
      }
    }'
  ```
</CodeGroup>

## Configuration

| Field        | Description                       | Required           |
| ------------ | --------------------------------- | ------------------ |
| `recipients` | List of email addresses to notify | Yes (at least one) |

## Email content

DevHelm emails include:

* Incident severity and current status
* Monitor name and type
* Affected regions
* Timestamp and duration
* Link to the incident in the Dashboard

## Troubleshooting

<AccordionGroup>
  <Accordion title="Emails going to spam">
    DevHelm sends from a verified domain. Add the sending address to your allowlist or check your organization's email filtering rules.
  </Accordion>

  <Accordion title="Not receiving emails">
    1. Verify the email addresses are correct
    2. Check spam/junk folders
    3. Run `devhelm alert-channels test <id>` to send a test notification
  </Accordion>
</AccordionGroup>