Recibir tu primer email entrante

Este inicio rápido configura un dominio para recibir emails, para que tu aplicación pueda gestionar respuestas, solicitudes de soporte o mensajes reenviados. Añadirás un registro DNS, enviarás un mensaje de prueba y después lo recibirás con un webhook y obtendrás su contenido completo con la API.

Antes de empezar

• Un dominio de envío verificado, como acme.com. El email entrante solo funciona en dominios verificados en tu espacio de trabajo. Consulta Añadir un dominio.
• Créditos en el espacio de trabajo. Cada email recibido cuesta 1 crédito.

Cómo funcionan las direcciones de entrada

Emailit recibe el correo en un subdominio de tu dominio de envío, por defecto inbound. Sirve cualquier dirección de ese subdominio, así que tanto support@inbound.acme.com como reply-4821@inbound.acme.com llegan al mismo espacio de trabajo. Los registros MX de tu dominio principal, por ejemplo los de Google Workspace o Microsoft 365, no cambian.

Añadir el registro MX de entrada

1. Abre el dominio. Ve a Email API›Domains y abre acme.com. El registro MX de inbound.acme.com aparece con los demás registros DNS. Es opcional, así que el dominio sigue verificado sin él.

2. Añade el registro en tu proveedor de DNS.

   Tipo	Nombre	Valor	Prioridad
   MX	inbound.acme.com	inbound.emailitmail.com	10

   Algunos proveedores de DNS solo quieren inbound en el campo del nombre. Otros quieren el nombre completo.

3. Comprueba los DNS. Selecciona Check DNS en la página del dominio y espera a que el registro de entrada muestre OK. Los cambios de DNS suelen tardar unos minutos, pero pueden tardar hasta 48 horas.

Para recibir en otro subdominio, como replies.acme.com, define inbound_key como replies al crear o actualizar el dominio con la API y, después, publica el registro MX para ese nombre. El panel muestra el subdominio de entrada, pero no permite cambiarlo.

Enviar un email de prueba

Desde tu buzón personal, envía un email a cualquier dirección del subdominio de entrada, por ejemplo hello@inbound.acme.com.

Ve a Email API›Emails y abre la pestaña Incoming. El mensaje aparece con el estado received. Ábrelo para ver el remitente, las cabeceras, el contenido y los adjuntos.

Si no llega, comprueba que el registro MX muestra OK y que el dominio está verificado. Si al espacio de trabajo no le quedan créditos, Emailit rechaza el mensaje con un error temporal y el servidor del remitente vuelve a intentarlo más tarde.

Recibir avisos con un webhook

Para procesar el email entrante en tu aplicación, suscríbete al evento email.received.

1. Crea el webhook. Ve a Email API›Webhooks, selecciona Add webhook e introduce un nombre y tu endpoint HTTPS, por ejemplo https://acme.com/webhooks/emailit. Copia el secreto del webhook. Lo necesitas para verificar las firmas.

2. Elige el evento. Un webhook nuevo recibe todos los eventos. Abre la pestaña Settings del webhook y selecciona solo email.received, o mantén todos los eventos y fíltralos en tu código.

3. Envía otro email de prueba a hello@inbound.acme.com.

Emailit envía un POST firmado a tu endpoint. El cuerpo es un array JSON, porque una petición puede llevar hasta 100 eventos:

[
  {
    "event_id": "evt_2pXb7Lw9QmKc4RtN8yVd3Hs",
    "type": "email.received",
    "data": {
      "object": {
        "id": "em_2pXb7Kq4NvL8mWc3RtB9yZd",
        "object": "email",
        "from": "ada@example.com",
        "to": "hello@inbound.acme.com",
        "subject": "Question about my order",
        "created_at": "2026-10-01T09:30:12.418Z"
      }
    }
  }
]

El evento incluye el remitente, el destinatario y el asunto, pero no el cuerpo. Verifica la cabecera X-Emailit-Signature antes de fiarte de la petición. Consulta Firma de las peticiones.

Obtener el email completo

Usa el id del evento para obtener el mensaje con una clave de API Full Access:

curl https://api.emailit.com/v2/emails/em_2pXb7Kq4NvL8mWc3RtB9yZd \
  -H "Authorization: Bearer $EMAILIT_API_KEY"

La respuesta incluye las cabeceras analizadas, el cuerpo de texto y HTML, y los adjuntos:

{
  "object": "email",
  "id": "em_2pXb7Kq4NvL8mWc3RtB9yZd",
  "type": "inbound",
  "from": "ada@example.com",
  "to": "hello@inbound.acme.com",
  "subject": "Question about my order",
  "status": "received",
  "headers": { "...": "..." },
  "body": {
    "text": "Hi, where is my order #1042?",
    "html": "<p>Hi, where is my order #1042?</p>"
  },
  "attachments": []
}

Para obtener en su lugar el mensaje original, llama a GET /emails/{id}/raw. El contenido de los mensajes se conserva durante el periodo de retención de tu plan, así que obtenlo poco después de que llegue el evento. Consulta Retención de datos.

Precios

Cada email recibido cuesta 1 crédito, lo mismo que enviar uno. Consulta Créditos.

Próximos pasos