Cuatro integraciones de la API de LeadGrid que tu equipo usará de verdad

LeadGrid está construido API-first. Cada acción que puedes realizar en la interfaz, crear un expediente, mover un lead por una etapa, añadir una nota, asignar un propietario/a, es una llamada REST documentada. Es una decisión de diseño, no una característica secundaria.

Según el Postman 2025 State of the API Report, el 82% de las organizaciones han adoptado algún nivel de enfoque API-first. Los equipos que construyen sobre su herramienta de pipeline en lugar de a su alrededor son los que dejan de hacer la misma tarea manual dos veces por semana.

Aquí tienes cuatro integraciones que los equipos realmente construyen, con el código para demostrarlo.

1. El envío de un formulario web crea un expediente automáticamente

Esta es la más común. Tienes un formulario de contacto, una landing page o un enlace de referido de un socio. Alguien lo rellena. Ahora mismo, alguien de tu equipo copia esos datos manualmente en LeadGrid. Eso es lo primero que hay que eliminar.

La API de LeadGrid te permite llamar a POST /dossiers para crear un nuevo registro en cualquier pipeline. Un simple receptor de webhook en Node se encarga del resto:

// Activado por tu proveedor de formularios (Typeform, Tally, formulario nativo, da igual)
app.post('/webhook/new-lead', async (req, res) => {
  const { name, email, company } = req.body;
 
  await fetch('https://api.leadgrid.io/v1/dossiers', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.LEADGRID_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      pipelineId: 'your-pipeline-id',
      title: `${name} - ${company}`,
      fields: { email, company },
    }),
  });
 
  res.sendStatus(200);
});

Nuevo lead registrado. Sin copiar y pegar. Nadie se olvida.

2. El cambio de etapa envía una notificación de Slack

Los managers de ventas miran LeadGrid. El resto del equipo mira Slack. Si un deal pasa a "Negociación" o un candidato/a llega a "Entrevista final", tu canal de Slack debería saberlo antes de que nadie tenga que preguntar.

Los webhooks de LeadGrid te permiten suscribirte a eventos dossier.stage_changed. Cuando se activa, lo reenvías a tu webhook entrante de Slack:

app.post('/webhook/leadgrid-events', async (req, res) => {
  const { event, data } = req.body;
 
  if (event === 'dossier.stage_changed') {
    const { title, stage, pipelineId } = data;
 
    await fetch(process.env.SLACK_WEBHOOK_URL, {
      method: 'POST',
      headers: { 'Content-Type': 'application/json' },
      body: JSON.stringify({
        text: `Actualización del pipeline: *${title}* ha pasado a *${stage}*`,
      }),
    });
  }
 
  res.sendStatus(200);
});

Treinta líneas. Tu equipo deja de preguntar: "¿dónde está ese deal ahora mismo?"

3. Un deal cerrado envía un registro a tu sistema de RRHH o ERP

Cuando se cierra una colocación de recruitment o se firma un contrato comercial, tu backoffice necesita saberlo. Exportar manualmente desde LeadGrid e importar en tu plataforma de RRHH o ERP es exactamente el tipo de trabajo que genera errores el jueves por la tarde.

Suscríbete a eventos dossier.closed y envía los datos estructurados directamente:

if (event === 'dossier.closed') {
  const { id, title, fields } = data;
 
  // Push a tu sistema de RRHH, sustituye por la API de tu proveedor
  await fetch('https://api.your-hr-tool.com/employees', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.HR_API_KEY}`,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({
      name: fields.candidateName,
      email: fields.email,
      startDate: fields.startDate,
      role: fields.jobTitle,
    }),
  });
}

LeadGrid es el disparador. Tu sistema de RRHH recibe datos limpios y estructurados. Ni un CSV a la vista.

4. Informe nocturno del pipeline en tu bandeja de entrada

La dirección quiere un resumen cada mañana. ¿Qué se movió ayer? ¿Qué está atascado? ¿Qué necesita atención?

Un simple cron job que llama a GET /dossiers?filter=updated_since=yesterday y formatea el resultado lo cubre completamente:

// Ejecutar cada mañana a las 07:00 mediante cron o una función programada
const yesterday = new Date(Date.now() - 86400000).toISOString();
 
const response = await fetch(
  `https://api.leadgrid.io/v1/dossiers?updated_since=${yesterday}`,
  { headers: { 'Authorization': `Bearer ${process.env.LEADGRID_API_KEY}` } }
);
 
const { dossiers } = await response.json();
const summary = dossiers.map(d => `- ${d.title}: ${d.stage}`).join('\n');
 
// Enviar via Resend, Postmark o cualquier proveedor de email transaccional
await sendEmail({
  to: 'team@yourcompany.com',
  subject: `Actualización del pipeline - ${new Date().toLocaleDateString()}`,
  text: summary || 'Sin cambios desde ayer.',
});

El Postman 2025 State of the API Report también encontró que el 52% de los desarrolladores sufrieron breaking changes de proveedores externos en 2024. LeadGrid mantiene endpoints versionados (/v1/) para que tus integraciones no se rompan silenciosamente un martes por la mañana.

El patrón detrás de las cuatro

Cada una de estas integraciones sigue la misma estructura: escuchar un disparador (webhook o programación), llamar a la API de LeadGrid para leer o escribir datos, enviar el resultado a otro lugar. La superficie de la API es consistente, autenticada con un único bearer token, y devuelve JSON predecible.

Eso es lo que API-first significa en la práctica. No construyes flows dentro de LeadGrid. Los construyes encima.

Referencia completa de la API, documentación de autenticación y catálogo de eventos webhook en leadgrid.io/docs.

Empezar gratis →