Skip to main content
POST
Create Tenant

Authorizations

Authorization
string
header
required

HTTP Bearer Authentication. Generate a shared token via /authenticate/token, then pass it as Authorization: Bearer <token>.

Body

application/json
email
string<email>
required
fname
string
required
lname
string
required
post_code
string
required

Postal code (numbers only)

Required string length: 5
Example:

"28013"

dob
string<date>
required

Date of birth format (YYYY-MM-DD)

employment_status
enum<string>
required
Available options:
employed,
self_employed,
student,
unemployed,
retired,
public_servant
Example:

"employed"

current_annual_income
number
required
Required range: x >= 0
currency
string
required
Required string length: 3
Example:

"EUR"

phone_number
string
required

Phone number (numbers only)

Required string length: 6 - 15
dni_nie
string

Either dni_nie or passport_id is required. At least one of these identification fields must be provided.

passport_id
string

Either dni_nie or passport_id is required. At least one of these identification fields must be provided.

highest_qualification
enum<string>

Highest education level. Optional; send null or "" to omit.

Available options:
primary_education,
secondary_education,
vocational_education,
bachelors,
masters,
doctorate,
other_qualification
Example:

"masters"

employment_category
enum<string>
Available options:
public_servant,
military,
permanent,
temporary,
permanent_seasonal_worker,
paternity_or_maternity_leave,
medical_leave,
ownACompany,
freelancer
protected_housing_docs
string[]
about_me
string

Response

Tenant created successfully

status
enum<string>
required
Available options:
success
message
string
required
Example:

"Tenant created successfully"

data
object
required

Tenant fields returned after profile creation.