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

# Create a collection subaccount

> Create a collection subaccount



## OpenAPI

````yaml post /subaccounts
openapi: 3.0.0
info:
  title: Flutterwave v3
  description: >-
    The Flutterwave for Business(F4B) APIs collection for all v3 endpoints with
    pre-formatted requests and response examples.
  contact: {}
  version: '1.0'
servers:
  - url: https://api.flutterwave.com/v3
    variables: {}
security:
  - bearer: []
tags:
  - name: Charges
    description: >-
      The charge APIs includes several payment collection methods to help you
      collect payments.
  - name: Tokenized Charges
    description: Tokenize your customers' cards with Flutterwave for faster payments
  - name: Preauthorization
    description: Manage preauth attemps on card transactions
  - name: Transactions
    description: Manage transactions, query statuses, logs and fees
  - name: Transfers
    description: Transfers to local and international customers
  - name: Beneficiaries
    description: Manage transfer beneficiaries
  - name: Virtual Cards
    description: Manage Flutterwave virtual cards
  - name: Virtual Account Numbers
    description: Manage virtual accounts
  - name: Collection Subaccounts
    description: Manage Collection Subaccounts
  - name: Payout Subaccounts
    description: Manage Payout Subaccounts
  - name: Subscriptions
    description: Manage user subscriptions
  - name: Payment Plans
    description: Manage Payment Plans
  - name: Bill Payments
    description: Manage Bill Payments
  - name: Banks
    description: Fetch Bank Information
  - name: Misc
    description: >-
      Verify user information like bank verification numbers, card bins, account
      information
  - name: Settlements
    description: Manage your settlements
  - name: Otps
    description: Create and manage one time passwords (OTPs) for your applications
  - name: Chargebacks
    description: Manage Chargebacks
paths:
  /subaccounts:
    post:
      tags:
        - Collection Subaccounts
      summary: Create a collection subaccount
      description: Create a collection subaccount
      operationId: Createacollectionsubaccount
      parameters: []
      requestBody:
        description: ''
        content:
          application/json:
            schema:
              allOf:
                - $ref: '#/components/schemas/CreateacollectionsubaccountRequest'
                - example:
                    account_bank: '044'
                    account_number: '0690000034'
                    business_name: Example Business
                    business_email: user@gmail.com
                    business_contact: Example User
                    business_contact_mobile: '09080000000'
                    business_mobile: '08100000000'
                    country: NG
                    split_type: flat
                    split_value: '1000'
            example:
              account_bank: '044'
              account_number: '0690000034'
              business_name: Example Business
              business_email: user@gmail.com
              business_contact: Example User
              business_contact_mobile: '09080000000'
              business_mobile: '08100000000'
              country: NG
              split_type: flat
              split_value: '1000'
        required: true
      responses:
        '200':
          description: OK
          headers:
            X-Powered-By:
              content:
                text/plain:
                  schema:
                    type: string
                  example: Express
            Access-Control-Allow-Origin:
              content:
                text/plain:
                  schema:
                    type: string
                  example: '*'
            Access-Control-Allow-Headers:
              content:
                text/plain:
                  schema:
                    type: string
                  example: >-
                    Origin, X-Requested-With, Content-Type, Accept,
                    Authorization, v3-xapp-id, flw-auth-token, mra-auth-token,
                    alt_mode_auth
            Access-Control-Allow-Methods:
              content:
                text/plain:
                  schema:
                    type: string
                  example: PUT, POST, GET, DELETE, OPTIONS
            Content-Length:
              content:
                text/plain:
                  schema:
                    type: string
                  example: '380'
            ETag:
              content:
                text/plain:
                  schema:
                    type: string
                  example: W/"17c-gl+dV9PigMqm0JdWxJzsCg"
            Date:
              content:
                text/plain:
                  schema:
                    type: string
                  example: Mon, 20 Jan 2020 06:47:56 GMT
            Connection:
              content:
                text/plain:
                  schema:
                    type: string
                  example: keep-alive
          content:
            application/json; charset=utf-8:
              schema:
                allOf:
                  - $ref: '#/components/schemas/SampleSuccessResponse18'
                  - example:
                      status: success
                      message: Subaccount created
                      data:
                        id: 2181
                        account_number: '0690000037'
                        account_bank: '044'
                        full_name: Ibra Mili
                        created_at: '2020-01-20T06:47:56.000Z'
                        meta:
                          - meta_name: mem_adr
                            meta_value: '0x16241F327213'
                        split_type: percentage
                        split_value: 0.5
                        subaccount_id: RS_9BD2ACE480785E759A16FDE1874A6657
                        bank_name: ACCESS BANK NIGERIA
              example:
                status: success
                message: Subaccount created
                data:
                  id: 2181
                  account_number: '0690000037'
                  account_bank: '044'
                  full_name: Ibra Mili
                  created_at: '2020-01-20T06:47:56.000Z'
                  meta:
                    - meta_name: mem_adr
                      meta_value: '0x16241F327213'
                  split_type: percentage
                  split_value: 0.5
                  subaccount_id: RS_9BD2ACE480785E759A16FDE1874A6657
                  bank_name: ACCESS BANK NIGERIA
        '400':
          description: Bad Request
          headers:
            X-Powered-By:
              content:
                text/plain:
                  schema:
                    type: string
                  example: Express
            Access-Control-Allow-Origin:
              content:
                text/plain:
                  schema:
                    type: string
                  example: '*'
            Access-Control-Allow-Headers:
              content:
                text/plain:
                  schema:
                    type: string
                  example: >-
                    Origin, X-Requested-With, Content-Type, Accept,
                    Authorization, v3-xapp-id, flw-auth-token, mra-auth-token,
                    alt_mode_auth
            Access-Control-Allow-Methods:
              content:
                text/plain:
                  schema:
                    type: string
                  example: PUT, POST, GET, DELETE, OPTIONS
            Content-Length:
              content:
                text/plain:
                  schema:
                    type: string
                  example: '97'
            ETag:
              content:
                text/plain:
                  schema:
                    type: string
                  example: W/"61-jlYiVPoI7KT6ruFwDsae/w"
            Date:
              content:
                text/plain:
                  schema:
                    type: string
                  example: Thu, 23 Jan 2020 15:28:19 GMT
            Connection:
              content:
                text/plain:
                  schema:
                    type: string
                  example: keep-alive
          content:
            application/json; charset=utf-8:
              schema:
                allOf:
                  - $ref: '#/components/schemas/MissingInformationResponse1'
                  - example:
                      status: error
                      message: business_name is required , business_email is required
                      data: null
              example:
                status: error
                message: business_name is required , business_email is required
                data: null
      deprecated: false
components:
  schemas:
    CreateacollectionsubaccountRequest:
      title: CreateacollectionsubaccountRequest
      required:
        - account_bank
        - account_number
        - business_name
        - business_email
        - business_contact
        - business_contact_mobile
        - business_mobile
        - country
        - split_type
        - split_value
      type: object
      properties:
        account_bank:
          type: string
        account_number:
          type: string
        business_name:
          type: string
        business_email:
          type: string
        business_contact:
          type: string
        business_contact_mobile:
          type: string
        business_mobile:
          type: string
        country:
          type: string
        split_type:
          type: string
        split_value:
          type: string
      example:
        account_bank: '044'
        account_number: '0690000034'
        business_name: Example Business
        business_email: user@gmail.com
        business_contact: Example User
        business_contact_mobile: '09080000000'
        business_mobile: '08100000000'
        country: NG
        split_type: flat
        split_value: '1000'
    SampleSuccessResponse18:
      title: SampleSuccessResponse18
      required:
        - status
        - message
        - data
      type: object
      properties:
        status:
          type: string
        message:
          type: string
        data:
          $ref: '#/components/schemas/Data51'
      example:
        status: success
        message: Subaccount created
        data:
          id: 2181
          account_number: '0690000037'
          account_bank: '044'
          full_name: Ibra Mili
          created_at: '2020-01-20T06:47:56.000Z'
          meta:
            - meta_name: mem_adr
              meta_value: '0x16241F327213'
          split_type: percentage
          split_value: 0.5
          subaccount_id: RS_9BD2ACE480785E759A16FDE1874A6657
          bank_name: ACCESS BANK NIGERIA
    MissingInformationResponse1:
      title: MissingInformationResponse1
      required:
        - status
        - message
        - data
      type: object
      properties:
        status:
          type: string
        message:
          type: string
        data:
          type: string
          nullable: true
      example:
        status: error
        message: business_name is required , business_email is required
        data: null
    Data51:
      title: Data51
      required:
        - id
        - account_number
        - account_bank
        - full_name
        - created_at
        - meta
        - split_type
        - split_value
        - subaccount_id
        - bank_name
      type: object
      properties:
        id:
          type: integer
          format: int32
        account_number:
          type: string
        account_bank:
          type: string
        full_name:
          type: string
        created_at:
          type: string
        meta:
          type: array
          items:
            $ref: '#/components/schemas/Meta28'
          description: ''
        split_type:
          type: string
        split_value:
          type: number
        subaccount_id:
          type: string
        bank_name:
          type: string
      example:
        id: 2181
        account_number: '0690000037'
        account_bank: '044'
        full_name: Ibra Mili
        created_at: '2020-01-20T06:47:56.000Z'
        meta:
          - meta_name: mem_adr
            meta_value: '0x16241F327213'
        split_type: percentage
        split_value: 0.5
        subaccount_id: RS_9BD2ACE480785E759A16FDE1874A6657
        bank_name: ACCESS BANK NIGERIA
    Meta28:
      title: Meta28
      required:
        - meta_name
        - meta_value
      type: object
      properties:
        meta_name:
          type: string
        meta_value:
          type: string
      example:
        meta_name: mem_adr
        meta_value: '0x16241F327213'
  securitySchemes:
    bearer:
      type: http
      scheme: bearer

````