Webhooks

Los webhooks envían una solicitud HTTP a tu sistema cada vez que cambian los datos en Solid, así nunca necesitas consultar la API periódicamente.

Crear un webhookCopy Anchor Link

1. Ve a Configuración → API y Webhooks → Webhooks.
2. Haz clic en + Crear webhook e introduce una URL HTTPS pública.
3. Haz clic en Guardar. Los eventos empiezan a llegar de inmediato.

EventosCopy Anchor Link

PayloadCopy Anchor Link

Cada evento es un POST con un cuerpo JSON:

{
  "event": "person.created",
  "data": {
    "id": "abc12345",
    "name": { "firstName": "Ana", "lastName": "Souza" },
    "createdAt": "2026-09-30T15:30:45Z"
  },
  "timestamp": "2026-09-30T15:30:50Z"
}

Responde con cualquier estado 2xx para confirmar la entrega. Las demás respuestas se registran como fallos.

Verificar la firmaCopy Anchor Link

Cada solicitud va firmada para que puedas comprobar que proviene de Solid. Los encabezados conservan los nombres del motor de código abierto sobre el que está construido Solid:

import crypto from 'node:crypto';

export function isFromSolid(req, secret) {
  const timestamp = req.headers['x-twenty-webhook-timestamp'];
  const expected = crypto
    .createHmac('sha256', secret)
    .update(`${timestamp}:${JSON.stringify(req.body)}`)
    .digest('hex');
  return expected === req.headers['x-twenty-webhook-signature'];
}

Rechaza las solicitudes cuya firma no coincida e ignora las marcas de tiempo de más de unos minutos para evitar ataques de repetición.