1 Creating a Property
Create your first property via web interface or API
How to Create a Property
To start managing your property, you need to add it to the system. Go to the Properties section and click the "Create" button. Fill in the basic information about your property — this will take just a couple of minutes.
Navigation: Menu → Properties → Create, or go directly to the creation page.
For more details, see the Properties section in the Library.
Required Fields
When creating a property, you need to fill in the following fields:
Optional Fields
You can also fill in additional information:
Additional Characteristics
After filling in the basic fields, you can expand the additional characteristics section. These are optional and can be filled in later. The available characteristics depend on the property type:
What You Can Add Next
After creating a property, you can enrich it with additional information through the property menu:
For Developers: REST API
You can also create properties programmatically using the REST API. Expand the sections below to see the endpoints and examples.
POST Authentication
▶First, get a JWT token by sending your credentials to the login endpoint:
POST /api/v1/auth/login
Request Body:
{
"email": "[email protected]",
"password": "demo"
}
Response (200 OK):
{
"token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJS..."
}
POST Create Property
▶Use the token to create a new property via the API:
POST /api/v1/properties
Headers:
Authorization: Bearer {token}
Content-Type: application/json
Request Body:
{
"name": "My First Apartment",
"property_type_id": 2,
"country_id": 1,
"area_ref": "dcaadb64-610c-11e3-8c4a-0050568002cf",
"city_ref": "8d5a980d-391c-11dd-90d9-001a92567626",
"building_number": "15"
}
Response (201 Created):
{
"id": 123,
"name": "My First Apartment",
"property_type": "APARTMENT",
"country": {"id": 1, "code": "UA"},
"building_number": "15",
"status": "active"
}
cURL Examples
▶1. Authentication
curl -X POST https://landlordkeeper.com/api/v1/auth/login \
-H "Content-Type: application/json" \
-d '{"email":"[email protected]","password":"demo"}'
2. Create Property
curl -X POST https://landlordkeeper.com/api/v1/properties \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_TOKEN_HERE" \
-d '{
"name": "My First Apartment",
"property_type_id": 2,
"country_id": 1,
"area_ref": "dcaadb64-610c-11e3-8c4a-0050568002cf",
"city_ref": "8d5a980d-391c-11dd-90d9-001a92567626",
"building_number": "15"
}'