Doctolib propose-t-il une API publique pour créer des rendez-vous ?

Non, il n'existe pas d'API publique permettant à un praticien de créer des rendez-vous dans son propre agenda Doctolib depuis un outil tiers. C'est précisément ce que l'API de Docal.io rend possible : votre compte Docal.io sert de pont sécurisé vers votre agenda.

Comment obtenir une clé API ?

La clé se génère dans les réglages de votre compte Docal.io, une fois le mode rendez-vous activé par notre équipe, sur simple demande. Elle n'est affichée qu'une seule fois et seule son empreinte est conservée sur nos serveurs.

Que se passe-t-il si le créneau demandé est déjà pris ?

L'API refuse la création avec une erreur explicite (créneau indisponible). La réservation passe par le mécanisme de blocage de créneau de Doctolib, ce qui rend la double réservation impossible.

Le patient doit-il déjà exister dans Doctolib ?

Non. Si le patient existe dans votre patientèle, le rendez-vous est rattaché à sa fiche ; sinon elle est créée automatiquement à partir des informations transmises (prénom, nom et date de naissance au minimum).

Comment activer l'accès à l'API ?

L'API est incluse pendant l'essai, puis disponible en option mensuelle. Le mode rendez-vous qui l'ouvre s'active sur demande : écrivez-nous à support@docal.io en décrivant votre projet (site web, voicebot, logiciel métier...). Nous activons votre compte et vous accompagnons sur l'intégration.

Une API pour créer des rendez-vous dans Doctolib : connectez vos propres outils

L'API REST de Docal.io crée de vrais rendez-vous patients dans un agenda Doctolib depuis n'importe quel outil : site web, voicebot, logiciel métier.

Vous voulez que votre site web, votre standard téléphonique intelligent ou votre logiciel métier crée directement des rendez-vous dans votre agenda Doctolib ? Il n'existe pas d'API publique Doctolib pour ça. Docal.io en propose une : une API REST sécurisée qui crée de vrais rendez-vous patients confirmés dans votre agenda. Incluse pendant l'essai, puis en option mensuelle.

Les cas d'usage

Votre propre site de réservation : le formulaire de votre site crée le rendez-vous directement dans Doctolib
Voicebot / secrétariat téléphonique intelligent : l'agent qui répond au téléphone réserve le créneau en temps réel
Logiciels métier et éditeurs : connectez votre solution de gestion de cabinet à l'agenda Doctolib de vos utilisateurs
CRM et planning du cabinet : lisez les rendez-vous pris pour créer la fiche patient dans votre CRM ou afficher le planning du jour, et signalez l'arrivée du patient en salle d'attente
Automatisations no-code : n8n, Make ou Zapier peuvent appeler l'API comme n'importe quel webhook (voir aussi notre intégration n8n)

Comment ça marche

L'authentification se fait par clé API (header X-API-Key), générée depuis vos réglages Docal.io. Trois endpoints suffisent :

GET /api/v1/agendas : la liste de vos agendas Doctolib et leurs identifiants
GET /api/v1/visit-motives : vos motifs de consultation disponibles
POST /api/v1/appointments : la création du rendez-vous

Exemple de création de rendez-vous :

POST /api/v1/appointments
X-API-Key: dk_live_...

{
  "agendaId": 123456,
  "visitMotiveId": 789,
  "start": "2026-08-01T10:00:00+02:00",
  "end": "2026-08-01T10:30:00+02:00",
  "patient": {
    "firstName": "Marie",
    "lastName": "Dupont",
    "birthdate": "1988-05-12",
    "email": "marie.dupont@email.fr",
    "phone": "+33612345678"
  }
}

En retour, l'identifiant du rendez-vous créé et son statut confirmé. Le patient est retrouvé dans votre patientèle ou créé automatiquement. Si le créneau est déjà occupé, l'API renvoie une erreur explicite : la double réservation est impossible, le créneau est verrouillé côté Doctolib pendant la réservation.

Lire le planning et suivre l'arrivée du patient

L'API ne se limite pas à la création. GET /api/v1/appointments liste les rendez-vous d'une journée (par défaut celle en cours) ou d'une plage de 31 jours au plus : horaires, agenda, motif, patient avec ses coordonnées et statut. POST /api/v1/appointments/{id}/status passe le patient en salle d'attente, en consultation ou vu, ou le ramène à confirmé, comme les boutons de Doctolib.

Un rendez-vous annulé ou un patient marqué absent ne change jamais de statut par l'API, et la réponse donne toujours le statut relu chez Doctolib, pas celui demandé.

Sécurité

Clé API révocable à tout moment depuis vos réglages, une seule clé active par compte
La clé n'est affichée qu'une fois et seule son empreinte (hash) est stockée sur nos serveurs
Vos identifiants Doctolib restent chiffrés (AES-256) ; l'API ne les expose jamais
Chaque erreur renvoie un code explicite (créneau indisponible, motif invalide, validation...) pour un débogage simple

Comment obtenir l'accès

L'API est en production. Le mode rendez-vous qui l'ouvre s'active sur demande : notre équipe active votre compte et vous accompagne sur l'intégration. C'est la même activation que le mode rendez-vous depuis Google Calendar : l'API en est le pendant pour développeurs.

Conclusion

Avec cette API, Doctolib cesse d'être un silo : vos propres outils, votre site et vos automatisations peuvent créer des rendez-vous patients complets dans votre agenda, en toute sécurité.

Un projet d'intégration ? La page de l'API détaille les endpoints, l'essai et l'offre partenaire pour les éditeurs et les agences. Pour toute question, écrivez-nous à support@docal.io avec une description de votre cas d'usage.