REST API›Organization›Enterprise Management

POST

Create an enterprise for an organization

Create an enterprise in the specified organization. Also create a user if it doesn't already exist. This endpoint is intended for creating enterprises in Crypto-as-a-Service (CaaS) organizations. For non-CaaS organizations, set isCaaS to false to skip validation.

Path Params

  • organizationId string required

    matches ^[0-9a-f]{32}$

Body Params

object

  • email string required

    at least 1 characters

  • idempotencyKey string required
    A unique identifier for the enterprise creation request. Multiple enterprises with the same organizationId and idempotencyKey will not be created.
  • additionalAdmins array of strings required
  • isCaaS boolean
    Indicates if this is a Crypto-as-a-Service (CaaS) organization. If set to true, validates that the organization configuration is complete before creating child enterprises.

    Defaults to true

  • accountType string enum
    The account type for the enterprise. Defaults to 'individual' if not specified.
    individualentity
  • thirdPartyIdentifier array of objects
    thirdPartyIdentifier object
    • id string required
      Identifier of the third party

      at least 1 characters

    • label string required
      Label for the third party

      at least 1 characters

Responses

200
OK

Response Body

object

  • enterpriseId string required

    at least 1 characters · matches ^[0-9a-f]{32}$

  • userId string required

    at least 1 characters · matches ^[a-f0-9]{32}$

400
Bad Request

Response Body

object

  • name string
    Error code
  • context map of objects required
    Properties that apply to a specific error name
    context object
    • <key> object
  • error string required
    Human-readable error message
  • requestId string required
    Client request id
403
Forbidden

Response Body

object

  • name string
    Error code
  • context map of objects required
    Properties that apply to a specific error name
    context object
    • <key> object
  • error string required
    Human-readable error message
  • requestId string required
    Client request id
404
Not Found

Response Body

object

  • name string
    Error code
  • context map of objects required
    Properties that apply to a specific error name
    context object
    • <key> object
  • error string required
    Human-readable error message
  • requestId string required
    Client request id
409
Conflict

Response Body

object

  • name string
    Error code
  • context map of objects required
    Properties that apply to a specific error name
    context object
    • <key> object
  • error string required
    Human-readable error message
  • requestId string required
    Client request id
500
Internal Server Error

Response Body

object

  • name string
    Error code
  • context map of objects required
    Properties that apply to a specific error name
    context object
    • <key> object
  • error string required
    Human-readable error message
  • requestId string required
    Client request id