> ## Documentation Index
> Fetch the complete documentation index at: https://docs.semicola.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create a buyer/seller account under the organization



## OpenAPI

````yaml /openapi/v3.yaml post /api/v2/accounts/create-child
openapi: 3.1.0
info:
  title: Semicola Exchange API
  version: 3.0.0-preview
  description: >-
    Platform endpoints of Semicola: sign-in and accounts, members and keys,
    billing, notifications, the Semi assistant (chat stream, confirmations,
    conversations), the MCP App widget host and realtime feeds. Typed agent
    tools live on the MCP server at /mcp/v3.
servers:
  - url: https://api.semicola.com
security:
  - bearerAuth: []
  - sessionCookie: []
tags:
  - name: Auth
  - name: Accounts
  - name: Billing
  - name: Notifications
  - name: Assistant
  - name: Widget host
  - name: Realtime
  - name: Demo
paths:
  /api/v2/accounts/create-child:
    post:
      tags:
        - Accounts
      summary: Create a buyer/seller account under the organization
      operationId: postAccountsCreateChild
      parameters:
        - name: Idempotency-Key
          in: header
          required: false
          schema:
            type: string
            minLength: 16
            maxLength: 255
            pattern: ^[A-Za-z0-9_.:-]+$
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                name:
                  type: string
                  minLength: 1
                  maxLength: 200
                accountType:
                  type: string
                  enum:
                    - BUYER
                    - SELLER
                    - PARTNER
                company:
                  type: string
                  maxLength: 200
              required:
                - name
                - accountType
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    anyOf:
                      - type: object
                        properties:
                          id:
                            type: integer
                            exclusiveMinimum: 0
                            maximum: 9007199254740991
                          name:
                            type: string
                          company:
                            type:
                              - string
                              - 'null'
                          kind:
                            type: string
                            enum:
                              - STANDALONE
                              - PARENT
                              - CHILD
                          nodeKind:
                            type: string
                            enum:
                              - ACCOUNT
                              - CONTAINER
                          accountType:
                            anyOf:
                              - type: string
                                enum:
                                  - BUYER
                                  - SELLER
                                  - PARTNER
                              - type: 'null'
                          role:
                            type: string
                            enum:
                              - SUPER_ADMIN
                              - ADMIN
                              - PREMIUM
                              - BASIC
                          membershipRole:
                            type: string
                            enum:
                              - MEMBER
                              - ADMIN
                          parentId:
                            anyOf:
                              - type: integer
                                exclusiveMinimum: 0
                                maximum: 9007199254740991
                              - type: 'null'
                          buyerAccessPosture:
                            anyOf:
                              - type: string
                                enum:
                                  - SANDBOX_ONLY
                                  - LIVE_ELIGIBLE
                              - type: 'null'
                        required:
                          - id
                          - name
                          - company
                          - kind
                          - nodeKind
                          - accountType
                          - role
                          - membershipRole
                          - parentId
                          - buyerAccessPosture
                        additionalProperties: false
                      - type: 'null'
                  error:
                    anyOf:
                      - type: object
                        properties:
                          code:
                            type: string
                          message:
                            type: string
                          field:
                            type: string
                          details: {}
                        required:
                          - code
                          - message
                        additionalProperties: false
                      - type: 'null'
                required:
                  - data
                  - error
                additionalProperties: false
        default:
          description: >-
            Error envelope `{data: null, error: {code, message, field?,
            details?}}`.
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key or OAuth access token.
    sessionCookie:
      type: apiKey
      in: cookie
      name: sc_session

````