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

# Create a website lead

> Recibe un formulario publico del sitio web, detecta su tipo y lo procesa con el pipeline correspondiente.



## OpenAPI

````yaml /generated/specs/sales.json post /api/v1/public/website-leads
openapi: 3.0.0
info:
  title: Raul API - Ventas
  description: >-
    Cotizaciones, pipeline, outreach comercial, equipos cotizables y ventas de
    equipamiento.
  version: 2.0.0
  contact: {}
servers:
  - url: https://api.raul.ugps.io
    description: Production
security: []
tags: []
paths:
  /api/v1/public/website-leads:
    post:
      tags:
        - Website Leads
      summary: Create a website lead
      description: >-
        Recibe un formulario publico del sitio web, detecta su tipo y lo procesa
        con el pipeline correspondiente.
      operationId: WebsiteLeadsController_createLead
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateWebsiteLeadDto'
      responses:
        '201':
          description: Lead created successfully
components:
  schemas:
    CreateWebsiteLeadDto:
      type: object
      properties:
        formType:
          type: string
          description: Tipo de formulario web
          enum:
            - quote
            - contact
            - support
            - email_capture
        nombre:
          type: string
          description: Nombre del prospecto o solicitante
        apellido:
          type: string
          description: Apellido del prospecto
        email:
          type: string
          description: Email del prospecto
        telefono:
          type: string
          description: Telefono del prospecto o solicitante
        empresa:
          type: string
          description: Empresa asociada al lead
        cargo:
          type: string
          description: Cargo del prospecto
        mensaje:
          type: string
          description: Mensaje adicional del prospecto
        cantidadVehiculos:
          type: number
          description: Cantidad aproximada de vehiculos
        industria:
          type: string
          description: Industria o rubro de la empresa
        soluciones:
          description: Soluciones de interes seleccionadas en el formulario
          type: array
          items:
            type: string
        tipoIncidencia:
          type: string
          description: Tipo de incidencia
        descripcion:
          type: string
          description: Descripcion del caso
        prioridad:
          type: string
          description: Prioridad declarada por el usuario
        utmSource:
          type: string
          description: UTM source de primer touch
        utmMedium:
          type: string
          description: UTM medium de primer touch
        utmCampaign:
          type: string
          description: UTM campaign de primer touch
        utmTerm:
          type: string
          description: UTM term de primer touch
        utmContent:
          type: string
          description: UTM content de primer touch
        gclid:
          type: string
          description: Google Click ID de primer touch
        fbclid:
          type: string
          description: Facebook Click ID de primer touch
        gaClientId:
          type: string
          description: Client ID de Google Analytics (_ga) para conversiones offline
        camposPersonalizados:
          description: Campos personalizados del formulario (máx 20, clave única por envío)
          maxItems: 20
          example:
            - clave: propiedad_flota
              etiqueta: Propiedad de la flota
              valor: De terceros
          type: array
          items:
            $ref: '#/components/schemas/CampoPersonalizadoDto'
      required:
        - formType
        - email
    CampoPersonalizadoDto:
      type: object
      properties:
        clave:
          type: string
          description: Identificador estable del campo (snake_case)
          pattern: ^[a-z][a-z0-9_]{0,63}$
          example: propiedad_flota
        etiqueta:
          type: string
          description: Etiqueta legible que se muestra en el CRM
          minLength: 1
          maxLength: 120
          example: Propiedad de la flota
        valor:
          description: >-
            Respuesta: texto (máx 500), número finito o booleano (se muestra
            como Sí/No)
          oneOf:
            - type: string
              maxLength: 500
            - type: number
            - type: boolean
          example: De terceros
      required:
        - clave
        - etiqueta
        - valor

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.