← Home Create Property

Create Property

POSThttps://api.bayut.com/v1/properties

This endpoint is used to create a property listing.

Default Behavior: Creating new property, it will automatically be saved as a Draft.
To publish it, you will need to take a separate action after creating the draft (e.g., using the Publish Property API).

🔐 Bearer Token: Provide your bearer token in the Authorization header when making requests to protected resources.

Query Parameters

Name	Type	Required	Description	Example
reference	string	Optional	The unique property reference number.	<= 255 characters
title	object	Optional	The property title in different languages.
en	string	Optional	The title in English.	<= 100 characters
ar	string	Optional	The title in Arabic.	<= 100 characters
description	object	Optional	The property description in different languages.
user_id	integer	Optional	The ID of the user posting the property.	101
user_email	string	Optional
purpose	enum<string>	Optional	Indicates whether the property is for sale or rent.	sale
category	string	Optional	The category of the listing, requires the slug of the Category. See theGET v1/categoriesendpoint for a list of valid Slugs.	apartment
furnishing_status	enum<string>	Optional
location_id	integer	Optional	The location of the listing, requires the ID of the Location. See theGET v1/locationsendpoint for a list of valid IDs.	501
construction_status	enum<string>	Optional
price	number	Optional	The price of the listing.	>= 1
rental_details	object	Optional
occupancy_status	enum<string>	Optional
rent_frequency	enum<string>	Optional
minimum_contract_period	integer	Optional
vacating_notice_period	integer	Optional
maintenance_fee	number	Optional
maintenance_fee_paid_by	enum<string>	Optional
sale_details	object	Optional
financing_available	enum<string>	Optional
financing_institute	string	Optional
sale_type	string	Optional	Off-plan sale type must be either new or resale	new
offplan_details	object	Optional
area	number	Optional	The built-up area of the property (sqft).	>= 1
plot_area	number	Optional	The plot area of the property (sqft).	>= 0
bedrooms	integer	Optional	The number of bedrooms. Use -1 for studio.	>= -1
bathrooms	integer	Optional	The number of bathrooms.	>= 0
permit_number	string	Optional
ownership_status	enum<string>	Optional
amenities	array[object]	Optional
id	string	Optional	The ID of the amenity. See theGET v1/amenitiesendpoint for a list of valid IDs.
value	string	Optional	An amenity can have either:A boolean value (e.g., Gym: true) indicating the amenity exists, orA numeric value (e.g., Elevators in Building: 23) indicating how many units of that amenity are available.	<= 255 characters
images	array[object]	Optional	Images associated with the property.	>= 1 items
path	string	Optional	Full URL to the image.	<= 2048 characters
is_main	boolean	Optional	Whether this image is the main property image.
videos	array[object]	Optional
host	enum<string>	Optional
link	string	Optional	Video URL.	<= 2048 characters
message	string	Optional	A success message confirming the property creation.	Property created successfully

Response Schema

Name	Type	Required	Description	Example
data	object	Optional	The detailed data of the created property.
area_unit	string	Optional	Unit of measurement for the area.	sqft
completion_status	enum<string>	Optional
completion_date	string	Optional
comment	string	Optional	Internal comment or note about the property.
verification_state	string	Optional
permit	object	Optional	Permit details for the property.
location	object	Optional	Detailed location information for the property.
user_detail	object	Optional	Information about the agent or user who posted the listing.
created_at	string	Optional
updated_at	string	Optional

Responses

201✅

422⚠️

401⚠️

403⚠️

Code Examples

curl --location 'https://api.bayut.com/v1/properties' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "reference": "REF-1283912839",
  "title": {
    "en": "Luxury 3BR Apartment in Downtown Dubai",
    "ar": "شقة فاخرة 3 غرف نوم في وسط مدينة دبي"
  },
  "description": {
    "en": "Beautiful luxury apartment with stunning city views, modern amenities, and premium finishes. Located in the heart of Downtown Dubai with easy access to Dubai Mall, Burj Khalifa, and major business districts.",
    "ar": "شقة فاخرة جميلة مع إطلالات خلابة على المدينة ووسائل راحة حديثة وتشطيبات عالية الجودة. تقع في قلب وسط مدينة دبي مع سهولة الوصول إلى دبي مول وبرج خليفة والمناطق التجارية الرئيسية."
  },
  "user_id": 2318195,
  "purpose": "rent",
  "category": "Apartments",
  "furnishing_status": "furnished",
  "location_id": 14550,
  "construction_status": "completed",
  "price": 150000,
  "rental_details": {
    "occupancy_status": "vacant",
    "rent_frequency": "yearly",
    "minimum_contract_period": 12,
    "vacating_notice_period": 3,
    "maintenance_fee": 5000,
    "maintenance_fee_paid_by": "tenant"
  },
  "sale_details": {
    "financing_available": "yes",
    "financing_institute": "Emirates NBD"
  },
  "offplan_details": {
    "sale_type": "new"
  },
  "area": 1200,
  "plot_area": 1500,
  "bedrooms": 3,
  "bathrooms": 2,
  "permit_number": "PERMIT-12345",
  "ownership_status": "freehold",
  "amenities": [
    {
      "id": "9",
      "value": "true"
    },
    {
      "id": "22",
      "value": "true"
    },
    {
      "id": "65",
      "value": "true"
    },
    {
      "id": "1",
      "value": "2026"
    },
    {
      "id": "16",
      "value": "28"
    }
  ],
  "images": [
    {
      "title": "Main Living Room",
      "path": "https://example.com/images/living-room.jpg",
      "is_main": true
    },
    {
      "title": "Master Bedroom",
      "path": "https://example.com/images/master-bedroom.jpg",
      "is_main": false
    },
    {
      "title": "Kitchen",
      "path": "https://example.com/images/kitchen.jpg",
      "is_main": false
    }
  ],
  "videos": [
    {
      "title": "Property Tour",
      "host": "youtube",
      "link": "https://www.youtube.com/watch?v=example"
    },
    {
      "title": "3D Virtual Tour",
      "host": "3d_view",
      "link": "https://example.com/3d-tour"
    }
  ]
}'

{
    "message": "Property created successfully",
    "data": {
        "id": 95,
        "reference": "REF-1283912839",
        "title": {
            "en": "Luxury 3BR Apartment in Downtown Dubai",
            "ar": "شقة فاخرة 3 غرف نوم في وسط مدينة دبي"
        },
        "description": {
            "en": "Beautiful luxury apartment with stunning city views, modern amenities, and premium finishes. Located in the heart of Downtown Dubai with easy access to Dubai Mall, Burj Khalifa, and major business districts.",
            "ar": "شقة فاخرة جميلة مع إطلالات خلابة على المدينة ووسائل راحة حديثة وتشطيبات عالية الجودة. تقع في قلب وسط مدينة دبي مع سهولة الوصول إلى دبي مول وبرج خليفة والمناطق التجارية الرئيسية."
        },
        "bedrooms": 3,
        "bathrooms": 2,
        "area": 1200,
        "area_unit": "sqft",
        "price": 150000,
        "purpose": {
            "en": "To Rent",
            "ar": null
        },
        "category": {
            "id": 4,
            "title": {
                "en": "Apartments",
                "ar": "شقة"
            },
            "parent_title": "Residential"
        },
        "rental_details": {
            "occupancy_status": "vacant",
            "rent_frequency": "yearly",
            "minimum_contract_period": "12",
            "vacating_notice_period": 3,
            "maintenance_fee": "5000",
            "maintenance_fee_paid_by": "tenant"
        },
        "furnishing_status": "furnished",
        "completion_status": "completed",
        "completion_date": null,
        "comment": null,
        "verification_state": null,
        "permit": {
            "number": "PERMIT-12345",
            "status": "pending"
        },
        "location": {
            "id": 14550,
            "title": {
                "en": "Jumeirah Garden City",
                "ar": "جميرا جاردن سيتي"
            },
            "breadcrumb": {
                "en": [
                    "UAE",
                    "Dubai",
                    "Al Satwa",
                    "Jumeirah Garden City"
                ],
                "ar": [
                    "الإمارات",
                    "دبي",
                    "السطوة",
                    "جميرا جاردن سيتي"
                ]
            },
            "coordinates": {
                "latitude": 25.222472556121,
                "longitude": 55.275030705226
            }
        },
        "user_detail": {
            "id": 335478,
            "name": {
                "en": "John Doe",
                "ar": ""
            },
            "about": "Real Estate Agent",
            "gender": "male",
            "image": "https://assets.stage.bayut.com/agents/UI26TKzy1c8W9GjVuGbeZQu1TQmaydQQR2BhZyYU",
            "experience_in_years": "10",
            "brn_number": "202401381679",
            "bln_number": "202401381679",
            "contact": {
                "email": "john.doe@gmail.com",
                "phone": "+971-4-3691700",
                "cell": null,
                "whatsapp": "+971569551551"
            }
        },
        "created_at": "2025-10-22T21:51:11.000000Z",
        "updated_at": "2025-10-22T21:51:12.000000Z"
    }
}