---
title: "Publicar una propiedad"
method: POST
path: "/properties"
tags: ["properties"]
---

# Publicar una propiedad

`POST /properties`

## Request

- Base URL: `https://api.inmo.example/v1`
- URL: `https://api.inmo.example/v1/properties`
- Auth: OAuth 2 (authorization code, authorization URL `https://www.propfacil.com/oauth/authorize`, token URL `https://www.propfacil.com/api/oauth/token`; client credentials, token URL `https://www.propfacil.com/api/oauth/token`, scopes: `properties:write`)

Crea una propiedad a nombre del usuario autenticado. Requiere OAuth2 con
scope `properties:write` (flujo authorization_code + PKCE). Pasa por
revisiones automáticas: si alguna falla responde `422` con los motivos y
NO se publica. Las `photos` (URLs) se descargan y optimizan a WebP en R2.

## Request body

- object
  - `transactionType` 'ForSale' | 'ForLease', required
  - `price` number, required
  - `currency` string
  - `title` string, required
  - `description` string, required
  - `city` string, required
  - `state` string
  - `bedrooms` integer
  - `bathrooms` number
  - `areaSqm` number
  - `latitude` number
  - `longitude` number
  - `isCommercial` boolean
  - `photos` string[]

## Response `201`

Publicada (en vivo).

- object
  - `status` 'published'
  - `id` string
  - `path` string
  - `url` string
  - `photosUploaded` integer

## Other responses

- `401`: Falta o es inválida la key de escritura.
- `422`: Rechazada por las revisiones automáticas.

---

[API](https://skmtc.dev/propfacil/apis/protocolo-propfacil-api.md) · [All operations](https://skmtc.dev/propfacil/apis/protocolo-propfacil-api/llms.txt) · [OpenAPI document](https://skmtc.dev/propfacil/apis/protocolo-propfacil-api/revisions/f0da7a416623?raw)