Skip to main content

​
POST /api/auth/confirm-account

Confirms a user account by validating the 6-digit token sent via email during registration.

​
Authentication

No authentication required.

​
Request Body

​
token
string
required
6-digit confirmation token sent to user’s email. Must be exactly 6 characters.

​
Request Example

{
  "token": "123456"
}

​
Response

​
message
string
Success message confirming account activation.
​
user
object
User data object.
​
user.id
number
User’s unique identifier.
​
user.email
string
User’s email address.
​
user.points
string
User’s current points balance.

​
Success Response (200 OK)

{
  "message": "Account confirmed",
  "user": {
    "id": 42,
    "email": "john@example.com",
    "points": "0"
  }
}

​
Error Responses

​
401 Unauthorized - Invalid Token

{
  "error": "Token not valid"
}

​
400 Bad Request - Validation Errors

{
  "errors": [
    {
      "msg": "Token not valid",
      "param": "token"
    }
  ]
}

​
cURL Example

curl -X POST https://api.example.com/api/auth/confirm-account \
  -H "Content-Type: application/json" \
  -d '{
    "token": "123456"
  }'

​
Notes

  • Token must be exactly 6 characters long
  • Once confirmed, the user’s confirmed field is set to true
  • Confirmed accounts can log in to the system
  • Rate limiting is applied to this endpoint

Build docs developers (and LLMs) love

Get started for freeTalk to us