*Workflows › Referencia › Eventos › Correo*

# Correo recibido

> Inicia una ejecución cuando ocurre «Correo recibido» en tu buzón o calendario conectado. La ejecución recibe el registro (correo) en `trigger_message` y los detalles del evento en `trigger_event`.

## Sobre este evento

| Propiedad | Valor |
| --- | --- |
| Origen | tu buzón o calendario conectado |
| Registro | Correo |
| Variable | `trigger_message` |

Solo inicia los workflows creados por el dueño del buzón o del calendario de donde viene el evento.

Más en [Triggers](https://docs.filmo.io/es/workflows/triggers).

EVENTO `email.received`

## Configuración

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `event` | string | Sí | El evento que espera este trigger: `email.received`. |
| `filter` | condition | No | La puerta del trigger: «solo cuando…». Una condición que se evalúa contra el evento y el registro antes de crear la ejecución; si no se cumple, no se crea ninguna. Si falta, no hay filtro y el evento pasa. Si existe, tiene que estar completa, con la variable elegida: guardar un filtro a medias se rechaza. |
| `provider` | enum<string> | No | Proveedor al que queda atado el trigger. Solo lo tienen los eventos de correo y de calendario, y se compara con la cuenta que originó el evento: un «correo recibido» de Gmail no se dispara por un buzón de Outlook. Si falta, se dispara para cualquier cuenta conectada. |

## Qué recibe la ejecución

| Nombre | Tipo | Descripción |
| --- | --- | --- |
| `trigger_message` | object | Correo |
| `trigger_message.id` | string | Id |
| `trigger_message.threadId` | string | Id del hilo |
| `trigger_message.subject` | string | Asunto |
| `trigger_message.fromEmail` | string | Correo del remitente |
| `trigger_message.fromName` | string | Nombre del remitente |
| `trigger_message.toEmails` | string | Destinatarios |
| `trigger_message.snippet` | string | Extracto |
| `trigger_message.date` | string | Fecha |
| `trigger_message.accountEmail` | string | Correo de la cuenta |
| `trigger_event` | object | El evento. Con cada evento llega el mismo sobre. |
| `trigger_event.name` | string | Nombre |
| `trigger_event.entityType` | string | Tipo de entidad |
| `trigger_event.entityId` | string | Id de la entidad |
| `trigger_event.entityName` | string | Nombre de la entidad |
| `trigger_event.actionCode` | string | Código de acción |
| `trigger_event.origin` | enum<string> | Origen `neo`, `workflow`, `api`, `mcp`, `integration` |
| `trigger_event.actor` | object | Autor |
| `trigger_event.actor.kind` | string | Tipo |
| `trigger_event.actor.id` | string | Id |
| `trigger_event.actor.name` | string | Nombre |
| `trigger_event.changes` | object | Cambios |

---

URL canónica: https://docs.filmo.io/es/workflows/reference/events/email-received  
Última actualización: 2026-10-25