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
- GET
/api/v1/propertiesdroit lectureÉtablissements visibles par la clé. - GET
/api/v1/roomsdroit lectureCatégories, chambres (avec leur état de ménage) et plans tarifaires.Paramètres : property_id - GET
/api/v1/availabilitydroit lectureChambres libres et prix du séjour pour chaque plan, par catégorie, avec les restrictions de la grille.Paramètres : property_id, arrival, departure, adults - GET
/api/v1/ratesdroit lectureGrille des prix jour par jour (62 jours au plus) : prix d'une nuit, durée minimale, fermetures.Paramètres : property_id, from, to - GET
/api/v1/invoicesdroit lectureFactures et avoirs émis sur une période (figés) : lignes, ventilation de TVA, totaux en centimes.Paramètres : property_id, from, to, limit, starting_after - POST
/api/v1/ratesdroit écritureModification en masse de la grille, comme l'écran Prix : prix fixé (centimes), variation (points de base ou centimes), durée minimale, fermetures. preview = true pour l'aperçu. Entre au journal, annulable depuis l'écran, envoyée aux canaux.Paramètres : property_id, from, to, weekdays (1 à 7), category_ids, action, value, preview - GET
/api/v1/reservationsdroit lectureSéjours qui chevauchent une période, triés par arrivée, paginés.Paramètres : property_id, from, to, status, updated_since, limit, starting_after - GET
/api/v1/reservations/{id}droit lectureUn séjour : chambre, client, lignes, total, payé, solde. - POST
/api/v1/reservationsdroit écritureCrée un séjour (chambre donnée ou première chambre libre de la catégorie), avec les mêmes règles que l'application. - POST
/api/v1/reservations/{id}/statusdroit écritureArrivée, départ, confirmation, annulation ou absence. - GET
/api/v1/guestsdroit lectureFiches clients du compte, paginées, avec l'accord marketing.Paramètres : email, updated_since, limit, starting_after - GET
/api/v1/guests/{id}droit lectureUne fiche client. - PATCH
/api/v1/guests/{id}droit écritureMet à jour prénom, nom, e-mail, téléphone, langue, société, ou l'accord marketing (marketing_consent : false enregistre une désinscription datée, true un nouvel accord daté). Une fiche anonymisée n'est plus modifiable.
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
reservation.createdséjour créé (application, API, calendrier iCal)reservation.booked_onlineséjour réservé sur votre moteur de réservationreservation.moveddates ou chambre changéesreservation.optionoption posée (paiement ou réponse attendue)reservation.confirmedoption ou demande confirméereservation.checked_inarrivée enregistréereservation.checked_outdépart enregistréreservation.cancelledannulationreservation.no_showabsencereservation.checkin_completedcheck-in en ligne rempli par le clientreservation.arrival_soonarrivée dans 3 jours (message de bienvenue, lien de check-in)reservation.arrival_todayjour de l'arrivée, dès 8 h (code d'accès, itinéraire)reservation.departure_todayjour du départ, dès 7 hreservation.stay_endedlendemain du départ, dès 10 h (demande d'avis)reservation.balance_duesolde à régler, arrivée dans 7 jours ou moinspayment.recordedpaiement encaissépayment.refundedremboursementinvoice.issuedfacture émiseinvoice.creditedavoir émisrates.changedgrille des prix modifiéevoucher.soldbon cadeau vendureview.receivedavis client reçuchannel.overbookingréservation d'un canal sans chambre librequote.accepteddevis accepté par le client (réservations créées)quote.declineddevis refusé par le clientguest.createdfiche client créée (application, moteur, canal, import)guest.updatedcoordonnées, langue ou accord marketing modifiésguest.anonymizedfiche anonymisée (droit à l'effacement) : supprimez le contact de votre côté
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
id, referenceidentifiant et référence courte affichée au clientstatusoption, confirmed, checked_in, checked_out, cancelled, no_showorigin, channel, channel_referenceorigine (staff, engine, channel, ical, quote, import), canal et sa référencearrival, departure, nights, arrival_timedates de séjour AAAA-MM-JJ, heure d'arrivée annoncéeadults, children, notevoyageurs et note de la réservationroomid, name, category_id, category, category_coderate_planid, name (ou null)guestid, first_name, last_name, name, email, phone, company, nationality, language, marketing_consenttotal_cents, paid_cents, balance_cents, currencymontants TTC en centimes, EURlineskind (night, extra, tourist_tax, adjustment), label, date, quantity, unit_cents, total_centscheckin_url, review_urllien de check-in en ligne (tant que le séjour n'est pas terminé), page d'avisaccesscode d'accès et wifi, sur arrival_today et checked_in si l'établissement l'a choisicancelled_at, checked_in_at, checked_out_at, created_at, updated_athorodatages ISO 8601
Champs d'un client
id, first_name, last_name, companyidentitéemail, phonecoordonnées (téléphone tel que saisi, souvent au format international)language, nationality, city, countrylangue (fr, en…), codes pays ISO à deux lettresvipclient signalé par l'établissementmarketing_consenttrue seulement si l'accord est donné, non retiré et la fiche non anonymisée : la seule valeur à lire avant un message commercialmarketing_consent_at, marketing_opt_out_at, anonymized_atdates de l'accord, de la désinscription, de l'anonymisation
Brancher TriggerFlow
- 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.
- 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.
- 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).
- 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.
- Une fiche anonymisée (guest.anonymized) doit être effacée de TriggerFlow.