# Create a property

Creates a property in your agency’s inventory.

Source: https://dev.alterestate.com/properties/create
Last updated: 2026-10-13

```http
POST https://secure.alterestate.com/api/v1/properties/create/
```

Authentication: `Authorization: Token your_api_key_here`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `name` | body | string | yes | Public property name. |
| `category` | body | number | yes | Category ID. See List properties. |
| `listing_type` | body | number | yes | 1 for sale, 2 for rent. |
| `sale_price` | body | number | no | Sale price. |
| `currency_sale` | body | string | no | Sale price currency. |
| `city` | body | number | no | City ID. |
| `sector` | body | number | no | Sector ID. |
| `room` | body | number | no | Bedrooms. |
| `bathroom` | body | number | no | Bathrooms. |
| `parkinglot` | body | number | no | Parking spaces. |
| `property_area` | body | number | no | Built area. |
| `description` | body | string | no | Long description. Stored text may be rendered as HTML later, so send plain text or HTML you trust. |

Example request:

```bash
curl --request POST \
  --url 'https://secure.alterestate.com/api/v1/properties/create/' \
  --header 'Authorization: Token your_api_key_here' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "Modern apartment in Naco",
  "category": 1,
  "listing_type": 1,
  "sale_price": 185000,
  "currency_sale": "USD",
  "city": 156,
  "sector": 2234,
  "room": 2,
  "bathroom": 2,
  "parkinglot": 1,
  "property_area": 110,
  "description": "Bright apartment with a balcony."
}'
```

Response 201 Created:

```json
{
  "uid": "JSORJ9S5AY",
  "cid": 292960,
  "slug": "modern-apartment-in-naco-292960",
  "name": "Modern apartment in Naco",
  "sale_price": 185000,
  "currency_sale": "USD"
}
```

Response 400 Bad Request:

```json
{
  "name": [
    "This field is required."
  ]
}
```

> Use the account token (Authorization: Token), the same one Leads uses. City and sector IDs come from Locations; category IDs are listed in List properties. This is the same URL the dashboard uses. A creation that does not come from the AlterEstate dashboard is recorded for support, with the fields that were saved. Do not send a dashboard client header.