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 (accès anticipé). 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 en accès anticipé : é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 (accès anticipé)

L'API REST de Docal.io permet de créer 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. En accès anticipé.

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
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": "[email protected]",
    "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.

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

Accès anticipé : comment l'obtenir

L'API est en production mais ouverte au cas par cas : chaque compte est activé manuellement par notre équipe, avec un accompagnement 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 ? Écrivez-nous à [email protected] avec une description de votre cas d'usage : nous activons les accès au fil de l'eau.