Disposable SMS inboxes for CI.

The SMS counterpart to test mail inboxes: spin up a throwaway number, trigger your OTP/2FA flow, then /wait for the text and assert on the extracted code — no phone, no manual step. Full schema in the API reference.

What it is

• Disposable inboxes that receive SMS via a relay, parsed into messages with extracted codes.
• /wait long-polls until a matching text arrives (or times out) — built for CI.
• Dormant-by-default: the module 503s until the server is configured with an SMS provider.

Create an inbox

$ curl -X POST https://login.ollastack.com/api/sms-inboxes \
     -H "Authorization: Bearer <token>" -H "Content-Type: application/json" \
     -d '{ "name": "signup OTP test" }'
{"success":true,"data":{"id":"...","phoneNumber":"+1...","name":"signup OTP test"}}

List with GET /api/sms-inboxes; delete with DELETE /api/sms-inboxes/{id}.

Wait for an OTP

$ curl "https://login.ollastack.com/api/sms-inboxes/<id>/wait?timeout=30" \
     -H "Authorization: Bearer <token>"
{"success":true,"data":{"message":{"body":"Your code is 482913","codes":["482913"]}}}

Read data.message.codes[0] — the OTP your test asserts on.

Read messages

$ curl "https://login.ollastack.com/api/sms-inboxes/<id>/messages" \
     -H "Authorization: Bearer <token>"