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

# Create Beneficiary



## OpenAPI

````yaml /novacrust-open-api-v2.yaml post /api/v1/business/open/beneficiary
openapi: 3.0.0
info:
  title: Open-API
  description: The http Integration API description
  version: '1.0'
  contact: {}
servers:
  - url: http://localhost:3050
    description: Local environment
  - url: https://api-staging.novacrust.com
    description: Staging environment
  - url: https://api-dev.novacrust.com
    description: Develop environment
security:
  - api-key: []
tags:
  - name: Customer
    description: ''
  - name: Payout Methods
    description: ''
  - name: Beneficiary
    description: ''
  - name: Payout
    description: ''
  - name: Transactions
    description: ''
  - name: Buy Gift Card
    description: ''
  - name: Sell Gift Card
    description: ''
  - name: Miscellaneous
    description: ''
paths:
  /api/v1/business/open/beneficiary:
    post:
      tags:
        - Beneficiary
      summary: Create Beneficiary
      operationId: create
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OpenApiCreateBeneficiaryDTO'
      responses:
        '201':
          description: ''
components:
  schemas:
    OpenApiCreateBeneficiaryDTO:
      type: object
      properties:
        currency:
          enum:
            - usd
            - ngn
            - ghs
            - eur
            - gbp
            - kes
            - zar
            - ugx
            - tzs
            - xof
            - rwf
            - zmw
            - xaf
            - gmd
            - lrd
            - mwk
            - etb
            - egp
            - sle
            - usdt
            - usdc
            - btc
            - eth
            - sol
            - trx
            - local_currency
          type: string
          description: The currency
          example: ngn
        metadata:
          type: object
          description: The beneficiary details
          example:
            name: Joke Silva
            account_number: '01000000010'
            bank_code: '066'
        payout_method_uuid:
          type: string
          description: The uuid of the Payout method
      required:
        - currency
        - metadata
        - payout_method_uuid
  securitySchemes:
    api-key:
      type: apiKey
      in: header
      name: authorization

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.