KintsugiKintsugi

Update organization details

PATCH/organization-details

Partial update of business details, addresses, and contact. Send only the fields you want to change: an omitted section or field is left unchanged, and a sent field is written exactly as sent. Send null to clear a field whose description says it accepts null; null on any other field returns 422. Send null for taxId to remove the tax id. taxId needs an incorporation country, sent or stored, or the request returns 400. A US ein that fails the format or all-zero check returns 400. Creates the details row on the first write. Contact SSN/DL and auto-file flags are not accepted.

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

businessDetailsBusinessDetailsUpdate

Identity and non-address business fields. Absent means no change.

addressesAddressesUpdate

Company, business, and/or mailing addresses. Absent means no change.

contactContactUpdate

Primary business contact (no SSN or driver's license). Absent means no change.

Response

businessDetailsOrganizationDetailsBusinessDetailsRequired

Identity and non-address business information.

addressesOrganizationDetailsAddressesRequired

Company, business, and mailing addresses.

contactOrganizationDetailsContactRequired

Primary business contact (no SSN or driver's license).

taxIdsOrganizationDetailsTaxId[]Required

Tax identification numbers registered for the organization.

200

Successful Response

400

The request was invalid.

401

Authentication failed or was missing.

404

The requested resource was not found.

422

The request failed validation.

cURL
PATCH /organization-details
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
{
"businessDetails": {
"businessName": "Acme Inc",
"entityType": "C_CORPORATION",
"dba": "Acme",
"incorporationState": "DE",
"ein": "12-3456789",
"businessDescription": "Sells software",
"firstOperationsDate": "2020-01-15",
"taxId": "12-3456789",
"homeStateRegistration": "HS-001",
"naics": "541511",
"businessPhone": "+1-415-555-0100",
"businessEmail": "ops@acme.example",
"businessFiscalYearEnd": "2026-12-31",
"accountingModel": "ACCRUAL",
"incorporationCountry": "US"
},
"addresses": {
"company": {
"address1": "123 Main St",
"address2": "Suite 100",
"city": "San Francisco",
"state": "CA",
"postalCode": "94105",
"countryCode": "US",
"cityIsUnincorporated": false
},
"business": {
"address1": "123 Main St",
"address2": "Suite 100",
"city": "San Francisco",
"state": "CA",
"postalCode": "94105",
"countryCode": "US"
},
"mailing": {
"address1": "123 Main St",
"address2": "Suite 100",
"city": "San Francisco",
"state": "CA",
"postalCode": "94105",
"countryCode": "US"
}
},
"contact": {
"name": "Jane Doe",
"phone": "+1-415-555-0101",
"email": "jane@acme.example",
"dob": "1985-04-12",
"title": "CEO",
"address1": "456 Oak Ave",
"address2": null,
"city": "Oakland",
"state": "CA",
"postalCode": "94607",
"countryCode": "US"
}
}
Response
{
"businessDetails": {
"businessName": "Acme Inc",
"entityType": "C_CORPORATION",
"dba": "Acme",
"incorporationState": "DE",
"ein": "12-3456789",
"businessDescription": "Sells software",
"homeStateRegistration": "HS-001",
"naics": "541511",
"firstOperationsDate": "2020-01-15",
"businessPhone": "+1-415-555-0100",
"businessEmail": "ops@acme.example",
"businessFiscalYearEnd": "2026-12-31",
"accountingModel": "ACCRUAL",
"incorporationCountry": "US"
},
"addresses": {
"company": {
"address1": "123 Main St",
"address2": "Suite 100",
"city": "San Francisco",
"state": "CA",
"postalCode": "94105",
"countryCode": "US",
"cityIsUnincorporated": false
},
"business": {
"address1": "123 Main St",
"address2": "Suite 100",
"city": "San Francisco",
"state": "CA",
"postalCode": "94105",
"countryCode": "US"
},
"mailing": {
"address1": "123 Main St",
"address2": "Suite 100",
"city": "San Francisco",
"state": "CA",
"postalCode": "94105",
"countryCode": "US"
}
},
"contact": {
"name": "Jane Doe",
"phone": "+1-415-555-0101",
"email": "jane@acme.example",
"dob": "1985-04-12",
"title": "CEO",
"address1": "456 Oak Ave",
"address2": null,
"city": "Oakland",
"state": "CA",
"postalCode": "94607",
"countryCode": "US"
},
"taxIds": [
{
"taxId": "12-3456789",
"stateCode": "CA",
"countryCode": "US"
}
]
}
Update organization details (2026-07-21) | Kintsugi API Reference