> ## 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 una conversión para un cliente

> Crea una conversión para un cliente existente.

**Identificación del cliente:**
El cliente debe ser identificado mediante uno de los siguientes campos:
- `email`: Email del cliente
- `clientExternalReference`: Referencia externa del cliente

**Nota:** Si no se proporciona ninguno de estos campos o no se encuentra un cliente, se devolverá un error.

**Prevención de duplicados:**
Si se proporciona `conversionExternalReference`, se evitarán conversiones duplicadas.

**Eventos automáticos:**
La conversión automáticamente disparará eventos de feedback a Meta Ads y TikTok si están configurados.



## OpenAPI

````yaml post /client/conversion
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/conversion:
    post:
      tags:
        - Client
      summary: Crear una conversión para un cliente
      description: >-
        Crea una conversión para un cliente existente.


        **Identificación del cliente:**

        El cliente debe ser identificado mediante uno de los siguientes campos:

        - `email`: Email del cliente

        - `clientExternalReference`: Referencia externa del cliente


        **Nota:** Si no se proporciona ninguno de estos campos o no se encuentra
        un cliente, se devolverá un error.


        **Prevención de duplicados:**

        Si se proporciona `conversionExternalReference`, se evitarán
        conversiones duplicadas.


        **Eventos automáticos:**

        La conversión automáticamente disparará eventos de feedback a Meta Ads y
        TikTok si están configurados.
      operationId: createConversion
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                email:
                  type: string
                  description: Email del cliente
                clientExternalReference:
                  type: string
                  description: Referencia externa del cliente
                amount:
                  type: number
                  description: Monto de la conversión
                currency:
                  type: string
                  enum:
                    - USD
                    - ARS
                conversionExternalReference:
                  type: string
                  description: Referencia externa de la conversión para prevenir duplicados
              required:
                - amount
                - currency
      responses:
        '201':
          description: Conversión creada exitosamente
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: number
                    description: ID de la conversión creada
                  leadId:
                    type: number
                    description: ID del lead asociado con la conversión
                required:
                  - id
                  - leadId
        '400':
          description: >-
            Solicitud incorrecta - datos de entrada inválidos o conversión ya
            existe
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                required:
                  - message
        '404':
          description: Cliente 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

````