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

# Crear

> Crea un nuevo cliente con la posibilidad de enviar una notificación que podría tener credenciales o no.



## OpenAPI

````yaml /api/openapi.json post /customers
openapi: 3.1.0
info:
  title: Riqra API
  version: '1.0'
  contact:
    email: soporte@riqra.com
    url: https://www.riqra.com/
    name: Riqra Support
  description: >-
    Usando nuestra API puedes integrar tu ERP o tu sistema actual de
    administración con [Riqra](https://www.riqra.com/).
servers:
  - url: https://sandbox.api.riqra.com
    description: Sandbox
  - description: Producción
    url: https://api.riqra.com
security:
  - API Key: []
tags:
  - name: Almacenes
  - name: Banners
  - name: Categorías
  - name: Clientes
  - name: Clientes - Direcciones
  - name: Cobertura
  - name: Comercio
  - name: Cupones
  - name: Inventario
  - name: Líneas de Crédito
  - name: Lista de Precios
  - name: Lista de Precios - Precios
  - name: Marcas
  - name: Pedidos
  - name: Productos
  - name: Productos Sugeridos
  - name: Promociones
  - name: Stock
  - name: Subcategorías
  - name: Variantes
paths:
  /customers:
    post:
      tags:
        - Clientes
      summary: Crear
      description: >-
        Crea un nuevo cliente con la posibilidad de enviar una notificación que
        podría tener credenciales o no.
      operationId: post-customers
      parameters: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                erpCode:
                  type: string
                firstName:
                  type: string
                  minLength: 1
                lastName:
                  type: string
                  minLength: 1
                email:
                  type: string
                  minLength: 1
                  description: Requerido si los clientes usan un email para iniciar sesión.
                loginCode:
                  type: string
                  minLength: 1
                  description: >-
                    Requerido si los clientes usan un código para iniciar
                    sesión, sino ignore este campo.
                phone:
                  type: string
                  minLength: 1
                password:
                  type: string
                  minLength: 1
                notification:
                  type: object
                  properties:
                    send:
                      type: boolean
                    withCredentials:
                      type: boolean
                  required:
                    - send
                    - withCredentials
                priceListId:
                  type: number
                  description: >-
                    Si no esta especificado, la lista de precios por defecto
                    será asignada.
                documents:
                  type: array
                  uniqueItems: true
                  minItems: 1
                  items:
                    type: object
                    properties:
                      number:
                        type: string
                        minLength: 1
                      fiscalName:
                        type: string
                        minLength: 1
                      fiscalAddress:
                        type: string
                        minLength: 1
                      email:
                        type: string
                        minLength: 1
                      isDefault:
                        type: boolean
                      forTaxes:
                        type: boolean
                    required:
                      - number
                      - fiscalName
                      - fiscalAddress
                      - isDefault
                      - forTaxes
              required:
                - password
      responses:
        '201':
          description: Created
          headers:
            Location:
              schema:
                type: string
              required: true
              description: Ubicación del recurso creado.
        '422':
          description: Unprocessable Entity
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BadRequest'
              examples:
                example-1:
                  value:
                    errors:
                      - message: string
                        code: string
components:
  schemas:
    BadRequest:
      title: BadRequest
      type: object
      x-examples: {}
      properties:
        errors:
          type: array
          items:
            type: object
            properties:
              message:
                type: string
              code:
                type:
                  - integer
                  - string
                deprecated: true
                description: Código referencial del error. No usar.
      description: ''
  securitySchemes:
    API Key:
      name: api-key
      type: apiKey
      in: header
      description: >-
        Todas las llamadas al API tienen que contener este header junto a la
        clave para poder autenticar y autorizar al cliente.

````