Register

​

POST /api/register/init

​

Request Body

​

Response

​

Status Codes

• 200 - OTP sent successfully
• 400 - Validation error (invalid email format, weak password, etc.)
• 409 - Account already exists with this email OR user already initiated registration (pending OTP verification)
• 500 - Failed to send OTP

​

Example Request

curl -X POST https://api.deployhub.cloud/api/register/init \
  -H "Content-Type: application/json" \
  -d '{
    "fullname": "John Doe",
    "email": "john@example.com",
    "password": "SecurePass123!"
  }'

​

Example Response

{
  "message": "Otp Sent Success"
}

​

Error Responses

{
  "message": "Password must be at least 8 characters and include uppercase, lowercase, number, and special character"
}

{
  "message": "Account Already Exist with this email"
}

{
  "message": "user already exist! please validate otp and create account"
}

{
  "error": "Failed To send otp"
}

​

POST /api/register/verify

​

Request Body

​

Response

​

Status Codes

• 201 - User registered successfully
• 400 - Validation error or invalid/expired OTP
• 404 - Registration not initiated for this email
• 500 - Internal server error

​

Example Request

curl -X POST https://api.deployhub.cloud/api/register/verify \
  -H "Content-Type: application/json" \
  -d '{
    "email": "john@example.com",
    "otp": "123456"
  }'

​

Example Response

{
  "message": "User register Success"
}

​

Error Responses

{
  "message": "Invalid Otp Or Expired"
}

{
  "message": "Otp Length is 6 and should be number"
}

{
  "message": "you not init register!"
}

{
  "error": "Internal Server Error"
}

​

Notes

• OTP codes expire after 10 minutes
• After successful verification, a welcome email is queued for delivery
• A subscription record is automatically created for the new user
• Temporary user data is removed after successful verification