Développeurs

API et webhooks

Tout ce que fait l'application, l'API le fait. JSON, montants en centimes TTC, dates de séjour au format AAAA-MM-JJ (une nuit compte sur sa date d'arrivée). Incluse à partir de la formule Essentiel.

Authentification

Créez une clé dans Plus, Intégrations. Elle commence par izp_live_, n'est affichée qu'une fois, et donne accès en lecture, ou en lecture et écriture, aux établissements du compte. 120 requêtes par minute et par clé.

curl https://pms.izzybook.fr/api/v1/reservations?from=2026-12-01&to=2026-12-31 \ -H "Authorization: Bearer izp_live_..."

Erreurs : { "error": { "code": "invalid_request", "message": "..." } } avec les codes HTTP 400, 401, 402 (formule), 403, 404, 409 (chambre déjà occupée), 429 et 500.

Points d'accès

property_id est facultatif quand la clé ne voit qu'un établissement. Pagination : limit (100 au plus), puis starting_after avec la valeur next_starting_after de la réponse.

Créer un séjour

POST /api/v1/reservations { "category_id": "…", "arrival": "2026-12-18", "departure": "2026-12-20", "adults": 2, "rate_plan_id": "…", "channel": "direct", "guest": { "first_name": "Claire", "last_name": "Martin", "email": "claire@exemple.fr" } }

Sans plan tarifaire, indiquez le prix d'une nuit (nightly_cents). La taxe de séjour est calculée par Izzy Book Hospitality.

Webhooks

Ajoutez une adresse https dans Plus, Intégrations, et choisissez les événements. Chaque événement part en moins d'une minute, en POST JSON, avec les en-têtes Izzy-Event, Izzy-Delivery et Izzy-Signature. Sans réponse 2xx, nouvel essai après 1 min, 5 min, 30 min, 2 h, 6 h, 12 h puis 24 h.

Les événements de réservation contiennent la réservation complète, avec checkin_url (lien de check-in en ligne personnel du client, tant que le séjour n'est pas terminé) et review_url. Si l'établissement l'a choisi, reservation.arrival_today et reservation.checked_in portent aussi access (code d'accès, wifi) pour l'arrivée autonome.

{ "id": "evt_123", "type": "reservation.created", "created_at": "2026-11-16T09:12:00Z", "property_id": "…", "data": { "id": "…", "reference": "K7Q2PA", "status": "confirmed", "arrival": "2026-12-18", … } }

Vérifier la signature

Izzy-Signature: t=1763284320,v1=… : calculez HMAC SHA-256 de <t>.<corps brut> avec le secret du webhook, comparez à v1, refusez un horodatage de plus de 5 minutes.

import { createHmac, timingSafeEqual } from "node:crypto"; function verify(secret, rawBody, header) { const { t, v1 } = Object.fromEntries(header.split(",").map((p) => p.split("="))); if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false; const expected = createHmac("sha256", secret).update(`${t}.${rawBody}`).digest(); return timingSafeEqual(expected, Buffer.from(v1, "hex")); }

Événements

Les événements de réservation contiennent la réservation complète, comme GET /api/v1/reservations/{id}. Les moments du séjour (J-3, jour J, départ, lendemain) partent une seule fois par réservation, à l'heure locale de l'établissement : branchez-les sur vos scénarios TriggerFlow.

Les événements guest.created et guest.updated contiennent la fiche client complète (champs ci-dessous). Les autres contiennent l'identifiant de l'objet et ses informations principales : relisez le détail par l'API si besoin.

Champs d'une réservation

Champs d'un client

Brancher TriggerFlow

  1. Dans Izzy Book Hospitality, Plus, Intégrations : créez une clé en lecture et écriture, puis un webhook vers l'adresse de réception TriggerFlow, avec les événements reservation.*, guest.* et review.received. Copiez le secret de signature dans TriggerFlow.
  2. Reprise des contacts : parcourez GET /api/v1/guests (100 par page) une fois, puis tenez la liste à jour par guest.created, guest.updated et guest.anonymized. En secours, GET /api/v1/guests?updated_since=… toutes les heures.
  3. Scénarios de séjour : reservation.created ou booked_online (confirmation), arrival_soon (bienvenue et lien de check-in), arrival_today (accès et itinéraire), departure_today, stay_ended (avis), balance_due (lien de paiement).
  4. Consentement : un message commercial ne part que si marketing_consent vaut true. Une désinscription reçue par SMS ou WhatsApp se renvoie par PATCH /api/v1/guests/{id} avec { "marketing_consent": false } : elle s'applique aussi aux campagnes e-mail d'Izzy Book Hospitality. Les messages liés au séjour (confirmation, accès, check-in) restent permis.
  5. Une fiche anonymisée (guest.anonymized) doit être effacée de TriggerFlow.