SMS and OTP testing

Check the code, not your patience

A dedicated number attached to an inbox, and the same API as email. The one-time code arrives already extracted.

// A dedicated number, attached to an inbox.
const number = await facteur.numbers.get('num_8fh2');

await page.getByLabel('Phone').fill(number.e164);
await page.getByRole('button', { name: 'Send me a code' }).click();

// Same API as email: we wait, we do not poll.
const sms = await facteur.messages.await({
  inbox: number.inboxId,
  sentTo: number.e164,
  timeout: 60_000,
});

expect(sms.otp).toBe('482913');   // already extracted
await page.getByLabel('Code received').fill(sms.otp);

Number availability

United Kingdom, United States, Canada
Provisioned immediately from the app.
France and the euro area
In progress. Receiving an OTP on a real French number is harder than it looks: operators tightly restrict mobile number usage, and a commercial A2P route does not guarantee delivery to a virtual number. We would rather open this when we can guarantee the reception rate than sell you a test that fails one time in twenty.

Need a specific country? Tell us: real demand decides our order of priority.

How it works

What the SMS module covers

The same model as email

messages.await

An SMS is a message like any other: same inbox, same search, same blocking wait, same code extraction. You do not learn a second API.

Code extraction

The one-time code is isolated from the text on arrival, whatever wording the sender used.

Per-inbox SMS quotas

Monthly inbound and outbound limits, set inbox by inbox, on every paid plan. A looping test does not drain everyone else’s counter.

Per-unit billing

4 € per number per month, 0,02 € per SMS received. No module to switch on, no monthly surcharge for the right to receive an SMS.

TOTP authenticator

For 2FA journeys based on an authenticator app rather than SMS: generate the six-digit codes from the API, with no phone in the loop.

History and export

Received SMS follow the same retention and the same export as emails, and appear in the same inbox view.

SMS is not an add-on

No module to switch on at tens of euros a month: a number, some messages, billed per unit.

Create a free account Migration guide