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

# Crear un nuevo cliente

> Crea un nuevo cliente usando una API key.

**Requisitos:**
Esta operación requiere una referencia de lead obtenida de un redirect de landing page mediante el campo `leadReference`.

**Comportamiento:**
Si se proporciona `externalReference` y ya existe un cliente con esa referencia, se devolverá el ID del cliente existente en lugar de crear uno nuevo.



## OpenAPI

````yaml post /client
openapi: 3.0.0
info:
  version: 1.0.0
  title: API de Convertix
  description: API de Convertix
servers:
  - url: https://api.convertixapp.com/api/v1
    variables: {}
security: []
paths:
  /client:
    post:
      tags:
        - Client
      summary: Crear un nuevo cliente
      description: >-
        Crea un nuevo cliente usando una API key.


        **Requisitos:**

        Esta operación requiere una referencia de lead obtenida de un redirect
        de landing page mediante el campo `leadReference`.


        **Comportamiento:**

        Si se proporciona `externalReference` y ya existe un cliente con esa
        referencia, se devolverá el ID del cliente existente en lugar de crear
        uno nuevo.
      operationId: createClient
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                phoneNumber:
                  type: string
                  description: Número de teléfono del cliente
                name:
                  type: string
                  description: Nombre completo del cliente
                email:
                  type: string
                  description: Email del cliente
                leadReference:
                  type: string
                  description: >-
                    Referencia del lead obtenida del redirect de la landing
                    page, ejemplo: "LD_1234ADD"
                externalReference:
                  type: string
                  description: >-
                    Referencia externa del cliente, esta referencia es algo que
                    puedes usar para identificar al cliente en tu sistema, si un
                    cliente ya está creado con la misma referencia externa vamos
                    a devolver el mismo ID de cliente
              required:
                - leadReference
      responses:
        '201':
          description: Cliente creado exitosamente o ID de cliente existente devuelto
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: number
                    description: ID del cliente
                required:
                  - id
        '400':
          description: Solicitud incorrecta, datos de entrada inválidos
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                required:
                  - message
        '404':
          description: Lead no encontrado
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                required:
                  - message
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````