Skip to main content
POST
Convert account into an organization

Authorizations

Authorization
string
header
required

API key or access token

Body

application/json

Request body for converting the current standalone account into an organization

confirmOrganizationConversion
enum<boolean>
required

Must be true after presenting that the conversion creates an organization, attaches this account to it as the organization's only account, moves contract and billing authority to the organization, makes the confirmer an organization administrator, keeps existing members account-only, applies account-specific standing before inherited organization standing, and cannot be undone without a dedicated migration.

Available options:
true
Example:

true

organizationName
string

Name for the new organization. Defaults to the account's name.

Required string length: 1 - 255
Example:

"Acme HQ"

Response

Convert account into an organization

Result of converting a standalone account into an organization

organizationId
integer
required

Customer ID of the new organization.

Required range: 0 < x <= 9007199254740991
Example:

812

accountId
integer
required

Customer ID of the converted account, now the organization's account.

Required range: 0 < x <= 9007199254740991
Example:

105

alreadyCompleted
boolean
required

True when the account had already been converted and this call returned that result.

Example:

false