---
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`

## Request

- Base URL: `https://api.lofty.com`
- URL: `https://api.lofty.com/v1.0/leads/{leadId}/transaction/property/address`
- Auth: none required
- TypeScript: <https://skmtc.dev/lofty/apis/lofty-service-open-apis/docs/v1.0/leads/:leadId/transaction/property/address/post.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/lofty/apis/lofty-service-open-apis.md) - [All operations](https://skmtc.dev/lofty/apis/lofty-service-open-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/lofty/apis/lofty-service-open-apis/revisions/23e640467118?raw)