---
title: "Update Property Address"
method: POST
path: "/v1.0/leads/{leadId}/transaction/property/address"
tags: ["Lead Transaction"]
---

# Update Property Address

`POST /v1.0/leads/{leadId}/transaction/property/address`

Updates the property address of a transaction. The `transactionId` is carried in the request body, not the URL.

**Full replacement** — omitted fields are set to null. To update a single field, GET the current address first, modify, then resubmit the whole object.

## Path parameters

- `leadId` integer, required

## Headers

- `Authorization` string, required
- `Content-Type` string, required

## Request body

- LeadTransactionPropertyAddress
  - `transactionId` integer, required — Transaction ID whose property address is being queried or updated. Required on the update endpoint (carried in the request body, not the URL).
  - `unit` string — Unit / apartment number.
  - `label` string — Free-form label for the address (e.g. 'Investment', 'Primary Residence').
  - `state` string — State or province code.
  - `city` string — City.
  - `zipCode` string — Postal / ZIP code.
  - `streetAddress` string — Street address.
  - `county` string — County.

## Response `200`

Envelope {code, message}. code=0 indicates success.

- TransactionCallbackResponse — Simple envelope response used by Brokermint webhook and property-address endpoints. Business failures surface as HTTP 200 with a non-zero code; integrators must inspect the code field.
  - `code` integer — Business result code. 0 indicates success; non-zero values indicate a business failure (e.g. 200060 TRANSACTION_NOT_EXIST).
  - `message` string — Human-readable message that accompanies the code.

## Other responses

- `400` — transactionId missing from the request body (20012 INVALID_PARAMETER).
- `401` — Missing or invalid authentication token.
- `404` — Lead not manageable (20006 LEAD_NOT_EXIST) or transaction not found / not bound to leadId (200060 TRANSACTION_NOT_EXIST).
- `500` — Internal server error.

---

[API](https://skmtc.net/lofty/apis/lofty-service-open-apis.md) · [All operations](https://skmtc.net/lofty/apis/lofty-service-open-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lofty/lofty-service-open-apis/revisions/23e640467118/schema)