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

# Create A Sub Account

> Creates a new sub-account linked to the authenticated business account using the provided email.



## OpenAPI

````yaml POST /sub-accounts
openapi: 3.1.0
info:
  title: BoundlessPay API
  version: 1.0.0
servers: []
security: []
paths:
  /sub-accounts:
    post:
      description: >-
        Creates a new sub-account linked to the authenticated business account
        using the provided email.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - email
              properties:
                email:
                  type: string
                  format: email
                  example: example@gmail.com
      responses:
        '201':
          description: Sub-account created successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  message:
                    type: string
                    example: Sub-account created successfully
                  data:
                    type: object
                    properties:
                      reference:
                        type: string
                        example: rp1xwfiohwxr9gp
                      email:
                        type: string
                        format: email
                        example: example@gmail.com
                      status:
                        type: string
                        example: pending
                      createdAt:
                        type: string
                        format: date-time
                        example: '2026-03-20T13:36:18Z'
                  meta:
                    type: object
                    properties:
                      timestamp:
                        type: string
                        format: date-time
                        example: '2026-03-25T07:09:06Z'
                required:
                  - success
                  - message
                  - data
        '400':
          description: Invalid request (email already exists, invalid format, etc.)
        '401':
          description: Unauthorized - missing or invalid credentials
        '403':
          description: Forbidden - account type not allowed to create sub-accounts
        '409':
          description: Conflict - email already in use

````