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

# Create Customers

> Batch endpoint for banks to migrate/create customers.



## OpenAPI

````yaml POST /v1/bank/customers
openapi: 3.1.0
info:
  title: Peere Network API
  description: >-
    Comprehensive API documentation for Peere Network's payment platform,
    including Merchant, Bank, and Provider APIs
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.peere.network
    description: Production server
  - url: https://sandbox-api.peere.network
    description: Sandbox server
security:
  - bearerAuth: []
tags:
  - name: Merchant - Account Operations
    description: Merchant account management operations
  - name: Merchant - Find Customer
    description: Customer discovery and lookup operations for merchants
  - name: Merchant - Billing & Payment Operations
    description: Billing and payment processing for merchants
  - name: Merchant - Recurring Billing
    description: Subscription and recurring payment management
  - name: Merchant - Customer Decisions
    description: Customer authorization and decision management
  - name: Merchant - Refund Management
    description: Refund processing and management
  - name: Merchant - Transaction Management
    description: Transaction history and details
  - name: Merchant - Balance & Financial Operations
    description: Balance inquiries and financial operations
  - name: Merchant - Shared Operations
    description: Common operations shared across merchant services
  - name: Bank - Account Operations
    description: Bank account management operations
  - name: Bank - Customer Management
    description: Customer management for banks
  - name: Bank - Customer Device Management
    description: Device linking and management for bank customers
  - name: Bank - Customer Billing & Subscriptions
    description: Billing and subscription management for bank customers
  - name: Bank - Transaction Management
    description: Transaction processing and history for banks
  - name: Bank - Balance & Financial Operations
    description: Balance and financial operations for banks
  - name: Provider - Provider Management
    description: Provider account and profile management
  - name: Provider - Merchant Management
    description: Merchant management for providers
  - name: Provider - Merchant Trust Management
    description: Trust and verification management for merchants
  - name: Provider - Find Customer
    description: Customer discovery operations for providers
  - name: Provider - Billing Operations
    description: Billing operations on behalf of merchants
  - name: Provider - Refund Management
    description: Refund management on behalf of merchants
  - name: Provider - Recurring Billing
    description: Recurring billing management for providers
  - name: Provider - Customer Decisions
    description: Customer decision management for providers
  - name: Provider - Transaction Management
    description: Transaction management for providers
  - name: Provider - Balance & Financial Operations
    description: Balance and financial operations for providers
  - name: Provider - Shared Operations
    description: Common operations for providers
paths:
  /v1/bank/customers:
    post:
      tags:
        - Bank - Customer Management
      summary: Create Customers
      description: Batch endpoint for banks to migrate/create customers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                customers:
                  type: array
                  items:
                    $ref: '#/components/schemas/CreateCustomerRequest'
      responses:
        '201':
          description: Customers created successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreateCustomersResponse'
        '400':
          $ref: '#/components/responses/BadRequestError'
        '401':
          $ref: '#/components/responses/UnauthorizedError'
components:
  schemas:
    CreateCustomerRequest:
      type: object
      properties:
        clientRef:
          type: string
        firstname:
          type: string
        lastname:
          type: string
        middlename:
          type: string
        accountName:
          type: string
        email:
          type: string
        country:
          type: string
        address:
          type: string
        gender:
          type: string
        phone:
          type: string
        accountNumber:
          type: string
        reference:
          type: string
      required:
        - firstname
        - lastname
        - accountName
        - email
        - country
        - accountNumber
        - reference
    CreateCustomersResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        message:
          type: string
          example: Batch processed, customers will reflect shortly
        statusCode:
          type: integer
          example: 201
        data:
          type: object
          properties:
            batchId:
              type: string
            status:
              type: string
            summary:
              type: object
              properties:
                total:
                  type: integer
                successful:
                  type: integer
                failed:
                  type: integer
                duplicates:
                  type: integer
                invalidData:
                  type: integer
            data:
              type: object
              properties:
                createdCount:
                  type: integer
                customerIds:
                  type: array
                  items:
                    type: string
    Error:
      type: object
      required:
        - statusCode
        - success
        - message
      properties:
        statusCode:
          type: integer
          example: 400
        success:
          type: boolean
          example: false
        message:
          type: string
          example: Bad request
  responses:
    BadRequestError:
      description: Bad request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    UnauthorizedError:
      description: Authentication required
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````