Behavior Note
This operation is conditional on AUTH.verify_registration:
- If AUTH.verify_registration=true, registration does not create a session. The response omits sessionId/expiresAt and the user must verify email first.
- If AUTH.verify_registration=false, registration creates a session immediately and returns sessionId/expiresAt.
Canonical operation URL: https://flowless.dev/operations/registerPublic.html
Register Public User
POST
/auth/register/public
Register a new user account publicly. Requires X-Bridge-Secret header for security. Email and user_name must be unique. Behavior depends on AUTH.verify_registration: when true, no session is created at registration and the user must verify email first; when false, the response includes sessionId and expiresAt immediately.
Authorizations
BridgeSecret
Bridge secret for backend integration
Type
API Key (header: X-Bridge-Secret)
Request Body
application/json
JSON "email": "john@example.com", "password": "SecurePass123!", "name": "John", "last_name": "Doe"
{
}
Responses
Registration successful
application/json
JSON "success": true, "message": "Registration successful. Please check your email to verify your account.", "data": { "user": { "id": "usr_123abc", "email": "user@example.com", "name": "John", "last_name": "Doe", "user_type": "customer", "is_verified": false, "requiresVerification": true } }
{
}