KintsugiKintsugi

Create an organization

POST/organizations

Create a new organization. A portfolio credential links the new organization to its portfolio, so it enters that credential's scope. Admin or Owner only: returns 403 if your credential belongs to the portfolio but is not permitted to create organizations in it. Returns the created 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.

Body

namestringRequired

Display name of the organization.

isTestboolean

Whether this is a test organization. Defaults to false. A portfolio-authenticated create under a test partner always persists a test organization, even if this is false. A user-session create still honors the submitted flag.

Response

idstringRequired

Opaque unique identifier of the organization.

organizationIdstringRequired

Owning organization id. For an organization this equals id, included so every resource on the surface carries organizationId uniformly.

namestringRequired

Display name of the organization. Empty string if unset.

statusPublicOrganizationStatusEnumRequired

Lifecycle status of the organization.

Available options:ACTIVEARCHIVED
citystringRequired

Company city. Empty string if unset.

statestringRequired

Company state. Empty string if unset.

detailsOrganizationDetails

Directory-detail fields (entity type, masked EIN, industry, primary contact, registered-state count, portfolio join date). Present only when the request passes include=details; omitted otherwise.

addressLine1stringRequired

Company street address line 1. Empty string if unset.

addressLine2stringRequired

Company street address line 2. Empty string if unset.

postalCodestringRequired

Company postal code. Empty string if unset.

countryCodestringRequired

Company ISO-3166 country code. Empty string if unset.

createdAtstringRequired

When the organization was created.

updatedAtstringRequired

When the organization was last updated, or null if never.

201

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.

500

An unexpected error prevented the request from completing.

cURL
POST /organizations
-H "Api-Key: ***"
-H "Api-Version: 2026-07-21"
{
"name": "Acme, Inc.",
"isTest": false
}
Response
{
"id": "orgn_2mNpQr7Ls8f3k",
"organizationId": "orgn_2mNpQr7Ls8f3k",
"name": "Acme, Inc.",
"status": "ACTIVE",
"city": "San Francisco",
"state": "CA",
"details": {
"entityType": "C_CORPORATION",
"einMasked": "**-***6789",
"industry": "454110",
"primaryContactName": "Acme Corp",
"primaryContactEmail": "jane.doe@example.com",
"registeredStates": 1,
"clientSince": "2026-07-28T12:00:00Z"
},
"addressLine1": "123 Main St",
"addressLine2": "Suite 400",
"postalCode": "94107",
"countryCode": "US",
"createdAt": "2026-07-28T12:00:00Z",
"updatedAt": "2026-07-28T12:00:00Z"
}
Create an organization (2026-07-21) | Kintsugi API Reference