Documentation

Using an AI assistant? Paste minimoth.dev/llms-full.txt into your context for the full API reference.

Quickstart

Get an API key and send your first OTP in under 5 minutes.

Authentication

How to use your API key and what the rate limits are.

Sessions

Validate, refresh, and log out user sessions. Includes token lifecycle and the 10-second grace window.

Node.js SDK

Official SDK for Node.js, Express, and Next.js. Auto-refresh, phone normalisation, typed errors — no boilerplate.

Integrations

Firebase

Verify a phone number with MiniMoth, then mint a Firebase custom token from your own backend.

Supabase

Use MiniMoth as the Send SMS Hook for Supabase Auth — WhatsApp-first, SMS-fallback OTP delivery, zero app code changes.

Test Group

Let up to 5 real testers preview OTPs sent through your Supabase Test Hook — no real messages, no charge for the previews.

Recipes

Common integration patterns: OTP-only delivery, protecting routes, token refresh, and full SDK-based auth flows for Express and Next.js.

Error Codes

Complete list of stable error codes returned by the API. Safe to switch on in your code.

Branding

"Powered by MiniMoth" badges to display in your UI — helps users recognise the OTP sender before the message arrives.

Try the full OTP flow interactively in the sandbox — no SMS sent, no credits consumed. The same Playground also has a live test to send a real OTP to your phone (uses your credits).

Test in Playground →