Create User

Create a new user

Requires authentication

Endpoint

POST /users

Request Body

Field	Type	Required	Description
fullname	string	Yes	User’s full name
phoneNumber	string	Yes	Primary phone number
secondPhoneNumber	string	No	Secondary phone number
profilePhoto	string	No	URL to profile photo
nationality	string	No	User’s nationality
maritalStatus	string	No	SINGLE, MARRIED, DIVORCED, WIDOWED, SEPARATED, OTHER
gender	string	No	MALE or FEMALE
occupation	string	No	User’s occupation
employer	string	No	User’s employer
relationship	string	No	FATHER, MOTHER, SON, DAUGHTER, BROTHER, SISTER, OTHER
residentType	string	No	SINGLE, FAMILY, SHARED (default: SINGLE)
ownerId	UUID	No	Owner ID for family members
age	integer	No	User’s age
birthdate	string	No	User’s birth date (ISO string)
documents	UUID[]	No	Array of document IDs
isActive	boolean	No	Default: true

Example

{
  "fullname": "John Doe",
  "phoneNumber": "07518202480",
  "maritalStatus": "SINGLE",
  "nationality": "Syrian",
  "gender": "MALE",
  "age": 23,
  "occupation": "Engineer",
  "employer": "Tech Corp",
  "residentType": "SINGLE",
  "documents": ["doc-uuid-1", "doc-uuid-2"]
}

Response

{
  "success": true,
  "data": {
    "id": "uuid",
    "fullname": "John Doe",
    ...
  }
}