KintsugiKintsugi
API reference / Update organization details

Update organization details

PATCH/organization-details

Sectioned upsert of business details, addresses, and contact. Any subset of sections may be sent; absent sections are unchanged. A section that IS present replaces that section as a whole, so send every field you want to keep: the patch granularity is the section, not the field. Creates the details row when missing. 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",
"incorporationCountry": "US",
"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"
},
"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",
"incorporationCountry": "US",
"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"
},
"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