Backend et SDK

Webhooks

Envoyez les événements de votre application à Zapier, Make, n8n ou à votre serveur.

Dans l'outil de création, ouvrez Réglages → Webhooks, collez l'URL d'un endpoint et enregistrez (forfait Starter et plus). builder77 envoie alors un POST avec un corps JSON à chaque événement :

ÉvénementQuand
record.createdVotre application a créé un enregistrement
record.updatedUn enregistrement a été modifié
record.deletedUn enregistrement a été supprimé
user.signed_upQuelqu'un s'est inscrit dans votre application
test.pingVous avez cliqué sur « Envoyer un événement de test »
{
  "event": "record.created",
  "projectId": "abc123",
  "timestamp": "2026-10-01T10:00:00.000Z",
  "collection": "orders",
  "record": { "id": "…", "total": 42, "createdAt": "…" }
}

Vérifier les requêtes

Chaque requête porte un en-tête X-M77-Signature : le HMAC-SHA256 en hexadécimal du corps brut, calculé avec votre secret de signature (affiché dans les Réglages).

import crypto from 'node:crypto';
const expected = crypto.createHmac('sha256', process.env.M77_WEBHOOK_SECRET).update(rawBody).digest('hex');
if (expected !== req.headers['x-m77-signature']) return res.status(401).end();

Les webhooks sont envoyés une seule fois, avec un délai d'expiration de 8 secondes. Les URL doivent être publiques (les adresses de réseaux privés sont bloquées).