---
title: "Get mail in a smartphone test"
sidebarTitle: "Get mail"
description: "Verify that your app really sends an email. The step waits for it to land in a test mailbox and fails if nothing arrives in time."
lastUpdated: "2026-09-23"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

Verify that your app actually sends an email: a welcome message, an order confirmation, an invoice. The step waits for the email to land in a test mailbox and fails if nothing arrives.

## Parameters

| Parameter | Required | Description |
| ----------- | ---------- | ------------- |
| Mailbox | Yes | The test mailbox address that should receive the email. |
| Ignore error on this step | No | The run continues with the next step if no email arrives. Default: off. |

## Results and metrics

- **Email content**: the received email is attached to the step result, so you can read it when reviewing the run.
- **Timing**: start, end, and duration (in seconds). The duration tells you how long delivery took.
- **Status**: failed if no email arrives in the mailbox.

See [Email & SMS in tests](/tests/email-sms) for how test mailboxes work and how to address them.

## What's next?

<Columns cols={2}>
  <Card title="Get email code" icon="envelope" href="/tests/actions/smartphone/getemailcode">

    Extract a verification code from the email instead

</Card>
  <Card title="Get email link" icon="link" href="/tests/actions/smartphone/getemaillink">

    Extract a link from the email

</Card>
</Columns>