Sign Up

Create or update an account by submitting your details along with the OTP you received from Request OTP. All four required fields must be present and the OTP must still be valid.

Request

POST /auth/signup

string

required

The user’s display name.

string

required

The email address associated with the account.

string

required

The password for the new account.

string

required

The one-time password sent to your email via the Request OTP endpoint.

string

The account role. Accepted values: USER, RIDER, DRIVER, ADMIN. Defaults to the application’s default role if omitted.

Response

string

Returns "Account created/updated successfully." on success.

Example

curl -X POST http://localhost:8080/auth/signup \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Alex",
    "email": "alex@example.com",
    "password": "s3cur3P@ss",
    "otp": "482910"
  }'

{
  "message": "Account created/updated successfully."
}

The OTP must be valid and not expired. Request a new OTP via Request OTP if yours has expired.

Error codes

Status	Meaning
400	One or more required fields are missing, the OTP is absent, or the OTP is invalid/expired

Request OTP

Authentication

Rides

Payments

Notifications & Settings

Request

Response

Example

Error codes

​Request

​Response

​Example

​Error codes

Request

Response

Example

Error codes