> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.tester.army/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.tester.army/_mcp/server.

# SMS Phone Numbers

TesterArmy can give the agent a real phone number for your tests. This is useful for flows that require SMS verification - sign ups, SMS OTP login, phone number confirmation.

SMS phone numbers are enabled per workspace. If your team needs them, contact us and we will turn the feature on for you.

Each project gets one dedicated test phone number. It is provisioned the first time a test needs it and then stays the same across runs, so the agent can also log back into accounts it registered with that number in earlier tests.

## How it works

1. The agent requests the project's test phone number (provisioned automatically on first use)
2. Enters that number in the app to trigger the SMS
3. Waits for the SMS to arrive
4. Reads the message, extracts the OTP code or link
5. Continues the test (enters the code, clicks the link)

Only messages received during the current run are visible to the agent, so a code from a previous test can never be mistaken for a fresh one.

## Saving it as a test account

In **Project -> Test Accounts -> Add Credential**, pick **Phone / SMS OTP** and give it a name. This saves the project's number as a regular test account, so you can select it on login steps in your test plans just like any other credential. The agent fills the number into phone fields and reads the incoming verification code automatically.

## Notes

* Numbers are US or Canadian (+1). If your app restricts sign-ups by country or carrier, whitelist the test number in your test environment.
* SMS delivery usually takes a few seconds; the agent polls and continues as soon as the message arrives. If the SMS never arrives, the step fails and the run reports it as a bug.
* The agent never guesses verification codes. If a code does not arrive or the message is missing the code, the step fails.