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

# Recepción de correos

> Recibe correos en tu dominio verificado, configura MX, webhooks email.received y bandeja en el panel.

<Tip>
  Recibir correo es el **camino de vuelta**: alguien responde a `soporte@tudominio.com` y Notifique entrega el contenido en tu webhook y/o en la pestaña **Recibidos** del panel.
</Tip>

## Qué hay de nuevo

Además de **enviar** con dominio verificado, puedes **recibir** mensajes enviados a `@tudominio.com` (o subdominio registrado). El flujo usa MX en tu DNS, procesamiento inbound en la plataforma y el evento **`email.received`** en webhooks.

## Requisitos

1. **Dominio registrado y VERIFIED** para envío.
2. **Registro MX** apuntando al host inbound de Notifique — ver `inboundDnsRecords` en la API o panel.
3. **Canal Correo** habilitado en **Settings → Mensajes recibidos**.
4. **Webhook** con **`email.received`** (para automatización).

<Note>
  Por defecto, al habilitar recepción, la plataforma **envía webhook** y **no persiste** en el panel. Activa **Persistir** si quieres ver correos en **Correos → Recibidos**.
</Note>

## Consultar por API

Con **Persistir** activo, lista correos recibidos (scope `email:inbound:read`):

```bash theme={null}
curl "https://api.notifique.dev/v1/email/inbound?page=1&limit=20" \
  -H "Authorization: Bearer sk_live_..."

curl "https://api.notifique.dev/v1/email/inbound/INBOUND_ID" \
  -H "Authorization: Bearer sk_live_..."
```

Filtros: `q`, `domainId`, `dateFrom`, `dateTo`. Grupo **E-mails recebidos** en la pestaña Correo.

Con **`domainIds`** en la clave, solo correos de esos dominios. `domainId` inválido → **400**; dominio fuera de la clave → **403**; detalle de dominio no permitido → **404**.

## DNS para recepción

En crear, listar, obtener o verificar dominio, `data` incluye `dnsRecords`, `suggestedDnsRecords`, `inboundDnsRecords`, `dkim` y `verification`.

Ejemplo MX:

```json theme={null}
{
  "type": "MX",
  "name": "tudominio.com",
  "value": "10 inbound.notifique.dev"
}
```

El host MX debe resolver a un registro **A** válido (sin CNAME en el destino MX).

## Evento `email.received`

```json theme={null}
{
  "event": "email.received",
  "workspaceId": "clxx123...",
  "instanceId": "",
  "timestamp": "2026-08-12T11:30:00.000Z",
  "data": {
    "inboundEmailId": "clinbound1...",
    "persisted": true,
    "from": "cliente@example.com",
    "to": "soporte@tudominio.com",
    "subject": "Consulta pedido #123",
    "matchedRuleIds": [],
    "persistDeniedReason": null
  }
}
```

Detalles completos: [Eventos de webhooks](/es/emails-api/como-funciona/eventos-do-webhooks).

## Responder con hilo

En `POST /v1/email/messages`, usa **`headers`**: `In-Reply-To`, `References`, `Message-ID`, `X-Entity-Ref-ID`.

## Verificación de dominio

`POST /v1/email/domains/:id/verify` devuelve `verificationSummary` y `data.verification`. Códigos con HTTP **200**: [Respuestas de error](/es/guides/conceitos/resposta-de-erros).

## Próximos pasos

* [Quick Start](/es/emails-api/como-funciona/quick-start)
* [Eventos de webhooks](/es/emails-api/como-funciona/eventos-do-webhooks)
* [Ámbitos de API Key](/es/emails-api/como-funciona/escopos-da-api-key)