# Update a transaction's addresses

> PATCH /transactions/{transaction_id}/addresses

Source: https://docs.trykintsugi.com/reference/2026-07-21/update-a-transaction-s-addresses

PATCH /transactions/{transaction_id}/addresses

Update a transaction's addresses

Edit one or more of a transaction's addresses without touching its line items. Each address is upserted by its `type` (or `id`); a type you omit is left unchanged. Editing an address resets its validation, so `addressStatus` returns to `UNVERIFIED` and the address is re-verified on the next processing pass. Returns the updated transaction. Editing a transaction you do not own answers `404`, identical to one that does not exist.

Category: Transactions

Path parameters:
transaction_id (string, required) - The unique identifier of the transaction to edit.

Request body:
addresses (TransactionAddressEdit[], required) - Addresses to update on the transaction. Each is upserted by `type` (or `id`); a type you omit is left unchanged, and line items are never touched. Editing an address resets its validation, so it is re-verified on the next processing pass.
  type (PublicAddressTypeEnum, required) - Which address on the transaction to edit (its role).
    allowed values: BILL_TO, SHIP_TO, SHIP_FROM, BILL_FROM
  id (string) - Id of the address to edit. Omit to target the transaction's address of this `type`, creating one if it has none.
  street1 (string) - First line of the street address. Omit or send `null` to clear; send a value to set.
  street2 (string) - Second line of the street address. Omit or send `null` to clear; send a value to set.
  city (string) - City or locality. Omit or send `null` to clear; send a value to set.
  county (string) - County or district. Omit or send `null` to clear; send a value to set.
  state (string) - State or province code. Omit or send `null` to clear; send a value to set.
  postalCode (string) - Postal or ZIP code. Omit or send `null` to clear; send a value to set.
  country (string) - ISO-3166 alpha-2 country code. Omit or send `null` to clear; send a value to set.
  fullAddress (string) - Single-line full address. Omit or send `null` to clear; send a value to set.
  phone (string) - Contact phone for the address. Omit or send `null` to clear; send a value to set.

Response fields:
id (string, required) - Kintsugi's unique identifier for the transaction.
organizationId (string, required) - Organization the transaction belongs to. Present on every row because a portfolio-wide list spans organizations.
[truncated, see the reference page]

---

Index of every page: https://docs.trykintsugi.com/llms.txt