Maalam Integration API
Your catalogue in Maalam, kept by your own system.
Your CMS or ERP stays the source of truth. It pushes projects and units to Maalam with an API key, and Maalam tells it back the one thing only Maalam knows: when a buyer holds, reserves or buys a unit.
01
Get a key
The owner of your Maalam workspace creates one under Settings → API.
02
Push a project
One PUT with the project’s slug. Run it again and nothing changes.
03
Push its units
One PUT per unit, or up to a hundred in a batch — photos as links.
04
Hear back
A signed POST to your endpoint the moment a unit is held, reserved or sold.
Keyed by what you already have
Projects are addressed by their slug and units by their code — your identifiers, not ours. Your system never stores a Maalam id, and sending the same unit twice is the same unit.
PUT /v1/integration/projects/alasala/units/A-101
Authorization: Bearer mlm_live_…
{ "type": "apartment", "areaSqm": 150, "priceSar": 950000, "bedrooms": 3, "bathrooms": 2 }