Phone numbers for SMS OTP testing and development

Create dedicated phone numbers for QA, staging, CI, and application workflows. Receive SMS through MailSlurp APIs, extract verification codes, assert webhook delivery, and keep number usage traceable without shared devices.

Start free Talk to sales

Programmable phone numbers and SMS testing API

Trusted by top companies worldwide

Phone number dashboard

Create phone numbers from the webapp or API

Developers can provision phone numbers in code while admins and QA leads use the MailSlurp app to choose regions, line types, quality presets, tags, and team access for shared phone/SMS workflows.

9:41

MailSlurp

iMessageToday 9:32 AM

iMessage

Use a fresh phone identity for every critical run

Allocate numbers by environment, region, test worker, or customer journey. MailSlurp keeps the number, inbound message, extracted OTP, and final verification result tied to the same run so failures are easier to debug.

await page.click('[data-test="sign-up-create-account-button"]');
// wait for verification code
const sms = await mailslurp.waitController.waitForLatestSms({
  waitForSingleSmsOptions: {
    phoneNumberId: phone.id,
    unreadOnly: true,
    timeout: 30_000,
  }
})
// extract the confirmation code (so we can confirm the user)
const code = /([0-9]{6})$/.exec(sms.body)?.[1]!!;

9:41

MailSlurp

iMessageToday 9:32 AM

iMessage

MailSlurp (examples)

const sms = await mailslurp.waitController.waitForLatestSms({
  waitForSingleSmsOptions: {
    phoneNumberId: phone.id,
    timeout: 30_000,
    unreadOnly: true,
  },
});
expect(sms.body).toContain('Here is your code');
expect(sms.fromNumber).toEqual('+13252527014');

Create, reserve, read, and release phone numbers from code

Manage phone numbers as test and product infrastructure: provision a number, lock it during a flow, wait for inbound SMS, inspect message history, route events, and clean up when the workflow is complete.

MailSlurp (examples)

const sms = await mailslurp.waitController.waitForLatestSms({
  waitForSingleSmsOptions: {
    phoneNumberId: phone.id,
    timeout: 30_000,
    unreadOnly: true,
  },
});
expect(sms.body).toContain('Here is your code');
expect(sms.fromNumber).toEqual('+13252527014');

Phone checks are running

0 of 4 phone checks complete

Hide all checks

mailslurp: allocate phone number-Fresh test number reserved for this run

RequiredDetails

playwright: submit phone verification-Signup flow requested an SMS challenge

RequiredDetails

mailslurp: wait for sms otp-Latest inbound SMS captured from the real network

RequiredDetails

qa: extract verification code-One-time code parsed and submitted

RequiredDetails

Waiting for SMS verification checks

CI will unblock once the real SMS challenge completes.

CI phone testing

Gate phone-number workflows before they ship

Run allocation, SMS receipt, OTP extraction, webhook, and browser-completion checks in CI so signup, recovery, MFA, and inbound-message releases fail with useful evidence instead of timing noise.

Open SMS testing docs

Integrate MailSlurp Seamlessly

Integrate with any framework

Official plugins and SDKs for all major programming languages, frameworks, and test platforms. All functionality available via API or dashboard.

CI/CD Native

MailSlurp fits right into your existing development, testing, and CI/CD workflows. Deploy and iterate with confidence and actionable feedback.

Developer Integrations

Phone number workflows MailSlurp supports

Use dedicated numbers for the product paths where SMS timing, ownership, routing, and cleanup need to be observable.

Dedicated test numbers

Provision numbers for QA, staging, CI workers, or regional journeys without relying on shared phones or unmanaged inboxes.

Open SMS verification API

OTP and phone verification

Capture one-time codes from real SMS messages and assert signup, login, recovery, and MFA outcomes.

Open auth testing

Inbound SMS APIs

Receive, inspect, search, and route inbound SMS messages through APIs, webhooks, and application workflows.

Number pools and locks

Reserve numbers while a flow is running so parallel test jobs and repeated verification attempts stay isolated.

Regional coverage

Choose numbers for country-specific formatting, sender behavior, market tests, and customer-facing SMS workflows.

Explore UK numbers

Webhooks and cleanup

Send inbound SMS events to your systems and keep lifecycle cleanup visible when a run or workflow finishes.

Phone-number workflows at release scale

Mobile networks

20+

Test SMS workflows against real carrier behavior.

Messages processed

500 million+

Infrastructure for message-driven product journeys.

Developer APIs

SDKs

Create numbers, wait for SMS, and route events from code.