KintsugiKintsugi

Update transaction addresses in a batch

PUT/addresses/transactions

Update the addresses on a batch of transactions in one organization. Identify each address by id, or omit id and identify it by transactionId + type to upsert. Setting an address resets its transaction and re-queues address validation. Returns one UPDATED/FAILED result per input address, in request order; an upsert's result has a null addressId. Owner/Admin only: returns 403 if your credential may read the organization but is not permitted to edit addresses, and 404 if you do not own the resolved organization.

Authorization

Api-KeystringRequired

Your secret API key. Include it with every request.

Headers

Api-Versiondate

Release date, as YYYY-MM-DD. Defaults to 2026-07-21.

Organization-Idstring

Target organization id (Organization-Id selector).

Connection-Idstring

Target connection id; resolves to its organization.

Entity-Idstring

Platform entity id; resolves to a connection's organization.

Entity-Sourcestring

Optional source to disambiguate an Entity-Id.

Body

addressesTransactionAddressUpdateItem[]Required

The transaction addresses to update; at most 1000 per request.

Response

addressIdstring

Id of the address the outcome is for, or null for an upsert where no id was sent. Correlate a null result by its position in the request.

statusPublicAddressUpdateStatusEnumRequired

Whether the address was updated (UPDATED) or failed (FAILED).

Available options:UPDATEDFAILED
200

Successful Response

400

The request was invalid.

401

Authentication failed or was missing.

403

The credential is not permitted for this request.

404

The requested resource was not found.

409

The request conflicts with existing state.

422

The request failed validation.

cURL
PUT /addresses/transactions
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
{
"addresses": [
{
"id": "3f6c2b1e-8a4d-4c2e-9b1f-2d7e5a6c9f10",
"transactionId": "tran_2mNpQr7Ls8f3k",
"type": "BILL_TO",
"street1": "123 Main St",
"street2": "Suite 400",
"city": "San Francisco",
"county": "San Francisco County",
"state": "CA",
"postalCode": "94107",
"country": "US",
"fullAddress": "123 Main St, San Francisco, CA 94107, US",
"phone": "+1 415 555 0100"
}
]
}
Response
[
{
"addressId": "addr_2mNpQr7Ls8f3k",
"status": "UPDATED"
}
]
Update transaction addresses in a batch (2026-07-21) | Kintsugi API Reference