Send a test render of a template
POST/auth/email-templates/:type/test
Renders the template (override or default) using sample/provided variables
and sends to the recipient. The recipient must be in the application
test_recipients allowlist. Rate-limited.
When non-empty, test_recipients gates ALL auth emails this application
sends (magic link, password reset, email verification, and email OTP) —
not just these test renders. Only listed recipients receive auth email;
any other recipient is silently blocked. Use it to make a non-production
application safe from mass sends. An empty allowlist (the default)
imposes no restriction and every recipient receives auth email normally.
Request
Responses
- 200
- 400
- 401
- 403
- 422
Test email sent
Invalid email type or missing recipient
Missing or invalid application credentials
Recipient not in the application's test_recipients allowlist
No verified domain configured