MiniMoth's shared WhatsApp number stops delivering OTPs after 14 November. Read the notice

minimoth

Authentication

Every request to the MiniMoth API must include your project’s API key in the X-Api-Key header:

headers: {
  'X-Api-Key': 'mm_live_...',
  'Content-Type': 'application/json',
}

Find or regenerate your key any time from the dashboard under Project → Settings. Regenerating a key immediately invalidates the old one.

Using Node.js, Express, or Next.js? @minimoth/sdk-node attaches the X-Api-Key header for you — pass the key once to the client instead of setting it on every request:

import { MiniMoth } from '@minimoth/sdk-node'

const mm = new MiniMoth({
  apiKey: process.env.MINIMOTH_API_KEY,  // mm_live_...
})
// mm.otp.send(), mm.otp.verify(), etc. attach the header for you

See the Node.js SDK guide for the full API.

Rate limits

Endpoint Live key (mm_live_) Test key (mm_test_)
POST /v1/otp/send 3 per phone per 10 minutes 20 per phone per 10 minutes
POST /v1/otp/verify 5 attempts per OTP, then invalidated 20 attempts per OTP
POST /v1/session/validate 3000 requests/min 300 requests/min
Other /v1/* (refresh, logout, status) 1000 requests/min 100 requests/min

Supabase and Auth0 integrations

The Supabase and Auth0 integrations are limited per project and per phone number, separately from the API key limits above. Live and test calls to the same project share these counters.

Limit Value
Per phone number 3 OTP sends per 10 minutes
Per project (all numbers combined) 1000 requests per 10 minutes

Requests over either limit are rejected with HTTP 429, and the limit lifts automatically once the 10-minute window ends. To avoid hitting the per-phone limit, add a resend cooldown (about 60 seconds) in your app and don’t retry automatically while a request is still in flight.

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 →