---
title: "Get email code in a web test"
sidebarTitle: "Get email code"
description: "Test an email verification flow on the web end to end: the step watches a test mailbox, waits for the email, and extracts the code with AI."
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.

Test an email verification flow end to end. The step watches a test mailbox, waits for the email, extracts the code with AI, and stores it in a variable you can type into the confirmation field.

## Parameters

| Parameter | Required | Description |
| ----------- | ---------- | ------------- |
| Email to receive code | Yes | The test mailbox address that should receive the email containing the code. |
| Variable | Yes | Name of the variable that receives the code. Default: `MailCode`. |
| Ignore error on this step | No | The run continues with the next step if no code is found. Default: off. |

## Results and metrics

- **Variable**: the extracted code is stored in the variable, ready to be typed into a confirmation field by a later Fill input step.
- **Timing**: start, end, and duration (in seconds). The duration includes waiting for the email to arrive.
- **Status**: failed if no email arrives or the AI finds no code in it.
- **AI usage**: the AI cost of the extraction is added to the run.

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

## What's next?

<Columns cols={2}>
  <Card title="Fill input" icon="keyboard" href="/tests/actions/web/input">

    Type the extracted code into the confirmation field

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

    Extract a confirmation link instead of a code

</Card>
</Columns>