ApiDocs | My Website

Resumen del endpoint

Método

POST

Dominio base

https://hs.cosit.com.mx/

Endpoint

/api/lead

Documentación oficial

https://hs.cosit.com.mx/api/lead/docs

URL completa

POST https://hs.cosit.com.mx/api/lead

Descripción

Este endpoint registra un nuevo lead (prospecto) en el sistema HS de COSIT. Recibe los datos de contacto del prospecto junto con la guía de interés y la fecha de registro, permitiendo al sistema de marketing y ventas dar seguimiento automatizado al prospecto.

Autenticación

🔐 Bearer Token (Vault) — El request utiliza la variable de vault auth_secret_05oc. El token debe enviarse en el header Authorization: Bearer .

Headers requeridos

Header	Valor	Descripción
`Content-Type`	application/json	Tipo de contenido del cuerpo
`Authorization`	Bearer {{auth_secret_05oc}}	Token de autenticación desde vault

Parámetros del cuerpo (JSON)

Campo	Tipo	Requerido	Descripción	Ejemplo
`nombre`	string	REQ	Nombre completo del prospecto	`"Juan Pérez"`
`email`	string	REQ	Correo electrónico de contacto	`"juan.perez@empresa.com"`
`puesto`	string	REQ	Cargo o puesto del prospecto en su organización	`"Director de TI"`
`guia`	string	REQ	Identificador slug de la guía de interés descargada	`"guia-dispositivos-ceo"`
`fecha`	string (ISO 8601)	REQ	Fecha y hora del registro del lead con zona horaria	`"2026-07-16T10:30:00-06:00"`

Ejemplo de request

{
        "nombre": "Juan Pérez",
        "email": "juan.perez@empresa.com",
        "puesto": "Director de TI",
        "guia": "guia-dispositivos-ceo",
        "fecha": "2026-07-16T10:30:00-06:00"
        }
      

Ejemplo cURL

curl -X POST https://hs.cosit.com.mx/api/lead \
        -H "Content-Type: application/json" \
        -H "Authorization: Bearer " \
        -d '{
          "nombre": "Juan Pérez",
          "email": "juan.perez@empresa.com",
          "puesto": "Director de TI",
          "guia": "guia-dispositivos-ceo",
          "fecha": "2026-07-16T10:30:00-06:00"
          }'

Códigos de respuesta esperados

Código	Estado	Descripción
200 / 201	Éxito	Lead registrado correctamente en el sistema
400	Bad Request	Campos faltantes o formato de datos incorrecto
401	Unauthorized	Token de autenticación inválido o expirado
500	Server Error	Error interno del servidor

Flujo de integración

1

Obtener token de autenticación

→

2

Construir payload JSON con datos del prospecto

→

3

POST a /api/lead con Bearer token

→

4

Verificar respuesta 200/201

Notas técnicas

• El campo fecha debe enviarse en formato ISO 8601 incluyendo la zona horaria (ej. -06:00 para CST México).
• El campo guia debe corresponder a un slug válido registrado en el sistema HS.
• La variable {{localhost}} en Postman debe reemplazarse por https://hs.cosit.com.mx en producción.
• Consultar la documentación interactiva en: https://hs.cosit.com.mx/api/lead/docs

Send Lead — Documento Técnico

Síganos