KintsugiKintsugi
API reference / Assign the business address to blank transactions

Assign the business address to blank transactions

POST/addresses/bulk-assign-business-address

Assign the organization's own business address to its selected blank-address transactions and re-queue validation. Ids that are not (or no longer) blank-eligible are ignored and reported. certified must be true. Returns businessAddressMissing: true (assigning nothing) when the organization has no business address configured. Owner/Admin only: 403 if your credential may read the organization but is not permitted, 404 if you do not own it, and 400 if certified is not set.

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

transactionIdsstring[]Required

Ids of the blank-address transactions to assign the business address to.

certifiedboolean

Must be true to certify the assignment; the request is rejected otherwise.

Response

updatedintegerRequired

Transactions the business address was assigned to.

skippedNoBusinessAddressintegerRequired

Eligible transactions skipped because the organization has no business address configured.

failedintegerRequired

Transactions whose address write failed.

ignoredintegerRequired

Requested transactions dropped because they were not (or no longer) blank-eligible.

businessAddressMissingbooleanRequired

true when the organization has no business address configured, so nothing was assigned. Set one and retry.

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
POST /addresses/bulk-assign-business-address
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
{
"transactionIds": [
"tran_2mNpQr7Ls8f3k"
],
"certified": false
}
Response
{
"updated": 3,
"skippedNoBusinessAddress": 0,
"failed": 0,
"ignored": 1,
"businessAddressMissing": false
}
Assign the business address to blank transactions (2026-07-21) | Kintsugi API Reference