Add properties to The Property Home

1. 1.Register as an agent and wait for admin approval (you get an email when you register).
2. 2.Sign in and open My Dashboard.
3. 3.In “Add a property” fill title, description, price, location, type, beds/baths/size.
4. 4.Tick common Key features from the suggestion chips, or type your own in the add box underneath and press Add.
5. 5.Upload up to 5 images (JPG/PNG/WebP).
6. 6.Submit — the listing goes live immediately for approved agents. You can edit it or mark it Sold at any time from “My listings”.

If your agency keeps properties in a spreadsheet or another system, send the file to the site admin (or import it together with the admin through the admin panel’s “Import CSV” tab).

Useful columns include:

• title· listing headline
• description· full property text
• price· asking price
• currency· e.g. EUR or GBP
• country· e.g. Spain
• city· e.g. Alicante
• propertyType· e.g. Apartment, Villa, House, Land
• bedrooms, bathrooms, sizeSqm· numbers (optional)
• reference· your internal id — keeps listings in sync
• features· separate multiple with ;
• images· up to 5 image links, separate with ;

A sample CSV is available on the admin import page. Rows missing a title or description are skipped, rows whose reference already exists for the selected agency update that listing instead of creating a duplicate, and the admin can edit anything afterwards.

Many agency software packages can export a feed (XML or a CSV file at a fixed web address). Send the feed address to the admin and your listings refresh automatically: new ones appear and removed ones get withdrawn.

Feeds are currently activated on request; standard Rightmove/OnTheMarket-style exports are supported.

Every approved agent can generate a personal API key in My Dashboard (API access card, “Generate API key”). Keep it secret; regenerate any time — the old key stops working immediately.

POST https://blissful-butterfly-426.api.macaly.app/api/properties/ingest
x-api-key: YOUR_API_KEY

Example request:

curl -X POST https://blissful-butterfly-426.api.macaly.app/api/properties/ingest \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{"title":"Sea View Villa","description":"Modern 3-bed villa with pool","price":450000,"currency":"EUR","country":"Spain","city":"Alicante","propertyType":"Villa","bedrooms":3,"bathrooms":2,"sizeSqm":120,"reference":"ABC123","imageUrls":["https://example.com/photo1.jpg"],"features":["Swimming Pool","Garage"]}'

Request body fields:

Responses:

{"created":1,"updated":0,"failed":0}   HTTP 200 on full success
HTTP 207 + errors array when some rows failed
401  invalid key
403  agency not approved yet

Tip: send an array or a { "properties": [...] } wrapper to push many listings in one call.