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

# Create a customer vault case

> Create an incomplete customer case (idempotent on partner_customer_ref).



## OpenAPI

````yaml /api-reference/openapi.json post /partner/customers
openapi: 3.1.0
info:
  title: Element Pay Partner API
  description: >-
    Provider-neutral fiat ↔ crypto ramps for partners. Discover corridors,
    create a binding quote, accept it, and receive webhooks. African local fiat
    (mobile money and bank) is auto-routed by corridor.
  version: 1.0.0
servers:
  - url: https://sandbox.elementpay.net/api/v1
    description: Sandbox
security:
  - APIKeyHeader: []
tags:
  - name: partner
    description: >-
      Corridor discovery, indicative rates, binding quotes, and order acceptance
      (including account currency conversion).
    x-group: Partner
  - name: partner-customers
    description: >-
      Vault KYC: requirements, create, list, get/update, documents, and submit
      (pcus_*).
    x-group: Customers
  - name: partner-customer-accounts
    description: >-
      Customer accounts and funding: open/list/get rails, deposit instructions,
      stablecoin sends, and same-currency fiat book transfers.
    x-group: Customer accounts
paths:
  /partner/customers:
    post:
      tags:
        - partner-customers
      summary: Create a customer vault case
      description: Create an incomplete customer case (idempotent on partner_customer_ref).
      operationId: partner_customer_create_partner_customers_post
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PartnerCustomerCreateRequest'
            examples:
              default:
                summary: Example
                value:
                  partner_customer_ref: cust-ke-001
                  type: individual
                  profile:
                    first_name: Jane
                    last_name: Doe
                    email: jane@example.com
                    date_of_birth: '1990-01-15'
                    country_of_residence: GB
                    phone: '+447700900123'
                    gender: f
                    address:
                      line_1: 1 Example Street
                      city: London
                      country: GB
                      postal_code: E1 6AN
            example:
              partner_customer_ref: cust-ke-001
              type: individual
              profile:
                first_name: Jane
                last_name: Doe
                email: jane@example.com
                date_of_birth: '1990-01-15'
                country_of_residence: GB
                phone: '+447700900123'
                gender: f
                address:
                  line_1: 1 Example Street
                  city: London
                  country: GB
                  postal_code: E1 6AN
      responses:
        '201':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                type: object
                required:
                  - status
                  - message
                properties:
                  status:
                    type: string
                    enum:
                      - error
                  message:
                    type: string
                  data:
                    type:
                      - object
                      - 'null'
              example:
                status: error
                message: Validation error
                data:
                  field: country
      security:
        - APIKeyHeader: []
components:
  schemas:
    PartnerCustomerCreateRequest:
      properties:
        partner_customer_ref:
          type: string
          maxLength: 128
          minLength: 1
          title: Partner Customer Ref
          description: Partner's stable customer reference (unique per tenant).
          examples:
            - cust-ke-001
          example: cust-ke-001
        type:
          type: string
          title: Type
          description: individual or business
          examples:
            - individual
          example: individual
        profile:
          anyOf:
            - type: object
            - type: 'null'
          title: Profile
          description: Identity / KYB fields (see GET /customers/requirements).
          example:
            first_name: Jane
            last_name: Doe
            email: jane@example.com
            date_of_birth: '1990-01-15'
            country_of_residence: GB
            phone: '+447700900123'
            gender: f
            address:
              line_1: 1 Example Street
              city: London
              country: GB
              postal_code: E1 6AN
      type: object
      required:
        - partner_customer_ref
        - type
      title: PartnerCustomerCreateRequest
      example:
        partner_customer_ref: cust-ke-001
        type: individual
        profile:
          first_name: Jane
          last_name: Doe
          email: jane@example.com
          date_of_birth: '1990-01-15'
          country_of_residence: GB
          phone: '+447700900123'
          gender: f
          address:
            line_1: 1 Example Street
            city: London
            country: GB
            postal_code: E1 6AN
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key

````