Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/eggarcia98/auth-backend/llms.txt

Use this file to discover all available pages before exploring further.

POST /api/v1/auth/signup Creates a new user account. Returns the created user and authentication tokens.

​
Request

​
Body parameters

​
email
string
required
The user’s email address. Must be a valid email format.
​
password
string
required
The user’s password. Must meet the following requirements:
  • At least 8 characters
  • At least one uppercase letter
  • At least one lowercase letter
  • At least one number

​
Response

​
success
boolean
Whether the request succeeded.
​
message
string
A human-readable message, e.g. "User registered successfully".
​
data
object

​
Examples

curl --request POST \
  --url https://your-api.example.com/api/v1/auth/signup \
  --header 'Content-Type: application/json' \
  --data '{
    "email": "user@example.com",
    "password": "Passw0rd"
  }'

​
Success response (201)

{
  "success": true,
  "message": "User registered successfully",
  "data": {
    "user": {
      "id": "b3e1c2d4-...",
      "email": "user@example.com",
      "emailVerified": false,
      "provider": "email",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "updatedAt": "2024-01-15T10:30:00.000Z"
    },
    "tokens": {
      "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
      "refreshToken": "v1.MRjY...",
      "expiresIn": 3600
    }
  }
}
If email confirmation is enabled on your Supabase project, tokens fields will be null until the user confirms their email. The user object is still returned with the response.

​
Errors

HTTP statusCodeDescription
400VALIDATION_ERRORThe request body is missing required fields or fails validation (e.g., weak password, invalid email).
409CONFLICTAn account with this email address already exists.

Build docs developers (and LLMs) love

Get started for freeTalk to us