Webhooks et API

Ajouter un point de terminaison

Connectez-vous, ouvrez Intégrations à partir de votre compte, puis ajoutez l’URL de votre point de terminaison sous Webhooks. Elle doit commencer par https. Choisissez les événements qu’il reçoit, ou tous.

Nolan affiche alors une seule fois le secret de signature du point de terminaison. Rangez-le avec vos autres secrets : il sert à vérifier qu’une requête vient bien de Nolan. « Nouveau secret » le remplace, et l’ancien cesse aussitôt de fonctionner.

« Envoyer un événement test » livre tout de suite un événement ping à ce point de terminaison, pour vérifier votre récepteur avant l’arrivée des vrais événements.

Ce que Nolan envoie

Une requête POST avec un corps JSON et ces en-têtes :

Vérifier la signature

La signature est un HMAC-SHA256, en hexadécimal minuscule, de l’horodatage, d’un point et du corps brut de la requête, avec le secret de signature du point de terminaison comme clé. Calculez-la sur le corps tel que reçu, avant toute lecture du JSON.

Refusez la requête si aucune valeur v1 ne correspond, ou si l’horodatage s’écarte de plus de cinq minutes de votre horloge. Comparez les signatures en temps constant. Pendant le remplacement d’un secret, vérifiez avec les deux.

Node.js

import crypto from 'node:crypto';

// rawBody: the request body exactly as received, as a string.
export function isFromLeaseOwl(rawBody, signatureHeader, secret, toleranceSeconds = 300) {
  const parts = Object.fromEntries(signatureHeader.split(',').map((part) => part.trim().split('=', 2)));
  const timestamp = Number(parts.t);
  if (!Number.isInteger(timestamp) || Math.abs(Date.now() / 1000 - timestamp) > toleranceSeconds) return false;
  const expected = crypto.createHmac('sha256', secret).update(`${timestamp}.${rawBody}`).digest();
  const given = Buffer.from(parts.v1 ?? '', 'hex');
  return given.length === expected.length && crypto.timingSafeEqual(given, expected);
}

Nouvelles tentatives et échecs

• Une livraison réussit quand votre point de terminaison répond avec un statut 2xx en moins de 10 secondes. Répondez d’abord, faites le travail ensuite.
• Toute autre réponse est relivrée après environ 1 minute, 5 minutes, 30 minutes, 2 heures, 6 heures, 12 heures et 24 heures : huit tentatives sur environ deux jours. Les relivraisons partent toutes les 15 minutes, alors les courts délais peuvent s’allonger.
• La livraison se fait au moins une fois. Un même événement peut arriver deux fois, et les événements peuvent arriver dans le désordre : utilisez l’identifiant de l’événement pour écarter les doublons, et les dates dans les données pour les ordonner.
• Les redirections ne sont pas suivies. Utilisez l’URL finale.
• Après la dernière tentative, la livraison est marquée en échec. Les livraisons en échec sont listées sous Webhooks dans votre page Intégrations, avec un bouton Réessayer.
• Un point de terminaison qui répond 410 Gone est désactivé. C’est ainsi que Zapier et Make se désabonnent.

L’événement

Chaque événement a la même enveloppe. data contient les objets propres à son type.

{
  "id": "evt_Qm3c9rT2xV8kLw1sZp4bNg",
  "type": "showing.booked",
  "created_at": "2026-10-07T23:47:12.311Z",
  "api_version": "2026-10-05",
  "organization_id": "4c0d6f3e-2b8a-4f61-9a57-0f3c1d2e8b90",
  "data": {
    "showing": {
      "id": "b7c1f0a2-5d3e-4c8b-8e21-6a9f0d4c3b12",
      "status": "booked",
      "starts_at": "2026-10-09T22:00:00.000Z",
      "ends_at": null,
      "when": "Thursday, October 9 at 6 p.m.",
      "previous_starts_at": null,
      "address": "Rue Saint-Denis near Rue Rachel",
      "listing": { "id": "7f3a1c2d-...", "address": "Rue Saint-Denis near Rue Rachel", "rent": 1950 }
    },
    "lead": {
      "id": "b1e4a9d0-...",
      "name": "Maya Tremblay",
      "phone": "+15145550142",
      "email": "",
      "status": "showing_booked",
      "lost_reason": null,
      "channel": "phone",
      "source": "Kijiji",
      "source_line": "+15145550100",
      "source_page": null,
      "listing": { "id": "7f3a1c2d-...", "address": "Rue Saint-Denis near Rue Rachel", "rent": 1950 },
      "wants": { "move_in": "November 1", "household": "2 adults", "pets": "1 cat", "unit": "Rue Saint-Denis near Rue Rachel" },
      "summary": "Wants the Plateau 4½ for November 1, works nearby, has one cat.",
      "callback_requested": false,
      "owner": null,
      "booking_id": "b7c1f0a2-5d3e-4c8b-8e21-6a9f0d4c3b12",
      "showing_at": "2026-10-09T22:00:00.000Z",
      "showing_outcome": null,
      "created_at": "2026-10-07T23:41:55.120Z",
      "last_contact_at": "2026-10-07T23:47:10.004Z"
    }
  }
}

Types d’événements

L’objet lead

API REST

Zapier, Make et vos propres scripts utilisent la même API, à https://getnolan.ai/api/v1/. Créez une clé sous « Clés d’API » dans votre page Intégrations. Elle n’est affichée qu’une fois.

Envoyez la clé dans l’en-tête Authorization comme jeton Bearer, jamais dans une URL. Une clé donne accès à une seule organisation : tout le reste répond 404.

Ajouter un prospect

curl https://getnolan.ai/api/v1/leads \
  -H "Authorization: Bearer $LEASEOWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Maya Tremblay", "phone": "514-555-0142", "source": "Kijiji", "summary": "Asked about the Plateau 4½"}'

Les erreurs répondent avec un statut et un corps JSON : { "error": { "code": "...", "message": "..." } }.

Versions

Chaque événement porte api_version. De nouveaux champs et de nouveaux types d’événements peuvent apparaître en tout temps : ignorez ce que vous ne connaissez pas. Un changement qui retire ou renomme un champ reçoit une nouvelle version, annoncée d’abord sur cette page.

Ouvrir vos intégrations