*Workflows › Reference › Steps*

# Find emails

> Searches the mailboxes of the workflow's creator by sender, subject, text and date range, and hands the results (up to 50) to the next steps.

## Behaviour

| Property | Value |
| --- | --- |
| Group in the editor | Integration |
| Integration | `email` |
| Retries | A step is not retried. If it fails (a step error, an HTTP answer that is not 2xx…), the run ends as failed and is not retried on its own, unless the step sits inside a «Try» step, which catches the failure so the run goes on. Only failures of the engine itself are retried, up to 3 attempts with waits of 30 and 60 seconds, and the retry skips the steps already completed. |
| Repeated runs | Not protected by the step itself; the journal of the run stops a completed step from running twice. |

More in [Steps](https://docs.filmo.io/workflows/steps).

STEP `integration_searchEmails`

## Configuration

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `fromEmail` | string | Yes | Partial match on the sender (address or name). |
| `subject` | string | Yes | Partial match on the subject. |
| `text` | string | Yes | Partial match on the snippet or the body. |
| `dateFrom` | string | Yes | A single day or a date variable; empty means no lower limit. |
| `dateTo` | string | Yes | A single day or a date variable; empty means no upper limit. |

## Values for the next steps

| Name | Type | Description |
| --- | --- | --- |
| `variables_<id>` | list | Emails |

---

Canonical URL: https://docs.filmo.io/workflows/reference/steps/integration-searchemails  
Last updated: 2026-10-25